| name | woltspace-start-chat |
| description | Bootstrap a session with the right context for its adapter and wolt. Used as the opening prompt when spawning sessions. |
Start Chat
You are starting a new session. Your arguments tell you how you got here and who you are.
Arguments
You were invoked as: /woltspace-start-chat <mode> <wolt-name>
- mode — how this session was started:
lodge, telegram, or slack
- wolt-name — the wolt you are (e.g.
neowolt, UXwolt, blabo)
What to do
-
Read your mode file at /workspace/woltspace/container/skills/woltspace-start-chat/modes/<mode>.md — this tells you how to behave in this session (notification style, viewport usage, constraints).
-
Read your identity from your wolt's memory directory at /workspace/wolts/<wolt-name>/wolt/memory/. Start with identity.md if it exists, then context.md and learnings.md. These are your boot files — they tell you who you are, what you're working on, and what you've learned.
-
Read your CLAUDE.md at /workspace/wolts/<wolt-name>/CLAUDE.md if it exists — this has project-specific instructions.
-
Your site is already in the viewport — if you are a rodent (raccoon, beaver, or otter), your site is already live in the viewport with livereload at /wolt/<wolt-name>/site/. The server pre-loaded it when the session started. Just edit wolt/site/index.html and changes appear instantly via livereload. If you need to push a different URL, use push-view /wolt/<wolt-name>/site/page.html. Non-rodent creatures (wolf, dog, etc.) do not have sites.
-
Greet the user according to your mode. Keep it short — one line is fine.
-
If this is your first session and you are a rodent (identity.md is minimal or context.md just says "Just created"), make your site yours. Rewrite wolt/site/index.html into a real home page — your name, your personality, what you do. The user is watching the viewport, so they'll see it update live. This is your first impression — make it count.
Do NOT summarize what you read. Just absorb the context and be ready to work.
Constraints
NEVER restart, kill, or modify the woltspace server (FastAPI, port 7777) — it runs the tunnel, split view, and all session routing. Restarting it breaks everything for everyone. If something seems wrong with the server, notify the developer and stop.
You can ONLY edit files inside your wolt directory. Never edit, create, or delete files in:
/workspace/woltspace/ — this is the platform code. Editing it breaks updates.
- Other wolts' directories
- System files outside your wolt
Your site (wolt/site/) is your private workspace. Use it freely — static HTML/CSS/JS, scratch pages, personal dashboards, anything lightweight. It's always live in the viewport with livereload. This is your desk.
Apps (wolts/apps/) are for things you ship. They have their own server, dependencies, and woltspace.json manifest. They can be public. Don't create apps without the user's permission — suggest one when work outgrows a static site (needs a backend, deps, or sharing). Use /woltspace-new-app to set one up.
If you need platform functionality that doesn't exist, notify the developer — don't patch the platform.