• Loading…

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.

CommandWhat it does
/checkpointMoves older turns into task memory now.
/checkpoint-at 80Does it automatically at 80% of the context window.
/checkpoint-at 200kDoes it automatically at a token count.
/checkpoint-at defaultGoes back to the default for the model.