Sessions
Starting work in a folder, adding files and images, steering while it works, and undoing a turn.
Starting
soreqen starts a session in the current folder. To work in another one, name it with -w (or --workspace), and to give the first instruction straight away, put it after the command:
soreqen "fix the failing test in src/cart.test.ts"
soreqen -w ~/projects/shop
Each folder keeps its own session. The mode and effort you used last in a folder are used again the next time you start there, unless you pass --mode or --effort.
In the desktop app, New session gives the agent a fresh, empty folder of its own, and Open a folder… lets it work in one of your projects.
While it works
- Add to the task by typing. SoreQen reads what you type at its next step, so you can correct course without stopping it.
- Attach a file with
@path, or an image by dropping it onto the terminal. - Stop a turn with Ctrl+C. At the prompt, Ctrl+C again quits. In the desktop app, press Esc.
- Commands: type
/to see them as you type; Tab completes the first. The full list is on Slash commands.
Starting over
/new begins a fresh conversation. /clear starts the current one over; your files stay as they are.
Undoing a turn
SoreQen keeps a checkpoint of your files before each turn, in every mode. /checkpoints lists the points you can go back to, and /rewind (or /rewind <turn>) undoes a turn's changes to the files.
In the desktop app, rewind from the message itself: "Rewind to this message? … the files are put back to how they were before that turn."
Long conversations
A session's context fills up as it grows. /context shows how full it is. Before it runs out, SoreQen moves older turns into task memory by itself, keeping what the work still needs; this is also called a checkpoint, of the conversation rather than the files.
| Command | What it does |
|---|---|
/checkpoint | Moves older turns into task memory now. |
/checkpoint-at 80 | Does it automatically at 80% of the context window. |
/checkpoint-at 200k | Does it automatically at a token count. |
/checkpoint-at default | Goes back to the default for the model. |