Skip to main content
This guide walks through drafting an agent spec in jstm agent plan and committing it. The chat is where you plan. Committing is a separate, explicit step.

​
Prerequisites

  • The jstm CLI, logged in. jstm whoami should show your workspace.
  • A real interactive terminal. The chat won’t run in a pipe or in CI.
1

Start a new draft

The chat opens with What should this agent do?. Describe the agent in plain language and press Enter:
Joyvis replies with a draft and follow-up questions. Keep refining over as many turns as you like.
Press Ctrl+J to add a newline without sending. Shift+Enter also works in some terminals, but Ctrl+J always works. Press Enter to send.With the input empty, press ↑ to recall your previous messages and ↓ to go back. Press PgUp and PgDn to scroll the transcript.
2

Resume an existing draft

Every session has an id, shown when you exit. To continue a draft later:
Your previous conversation replays into the chat and Joyvis keeps full context. New turns continue the same session, so what you commit later includes everything you discussed.If you lost the id, jstm agent plan list shows your sessions.
3

Exit — your work stays a draft

Leave the chat any way you like: type done, quit, exit, or save and press Enter, or press Ctrl+C or Ctrl+D.
None of these commit. Even typing save only exits. Exiting always leaves your spec as a draft — nothing is created or changed yet.
On exit you see:
Copy the session id. You need it for the next step.
4

Commit the draft into an agent

When the spec is ready, run the explicit commit command:
You see ✓ spec committed. This is the only step that creates or updates the agent. If you skip it, nothing changes — the draft waits for you.

​
Troubleshooting

​
Next steps