Skip to content

Daily workflow

A normal Exosuit day starts by asking the project where it is. Do that before you ask an agent to write code. The point is to work from the project’s current state, not from whatever the chat happens to remember.

Run:

Terminal window
exo status

This tells you the active phase, goals, tasks, and git state. If you are coming back cold, read this before doing anything else.

Then ask for the map:

Terminal window
exo map

exo map is the practical steering surface. It shows the active work and suggests next actions. If you want one answer instead of the whole map:

Terminal window
exo map --next

If a suggested command looks surprising, ask why:

Terminal window
exo map --why "exo task start <task-id>"

Use the hierarchy to keep the day small enough to reason about:

Terminal window
exo goal list
exo task list

Pick the task that belongs to the current goal. Start it before making changes:

Terminal window
exo task start <task-id>

As you work, log concrete progress:

Terminal window
exo task log <task-id> --log "What changed and what you learned"

The log is not a diary. It is the breadcrumb that lets the next session recover the thread.

The daily loop is SOAR: Status → Orient → Act → Review.

  • Status: exo status
  • Orient: exo map
  • Act: edit files, run commands, log progress
  • Review: run checks and record the outcome

You do not need to make this ceremonial. Just keep returning to the loop instead of letting the chat drift.

When the task is more than a quick edit, switch to Prepare → Execute → Review:

  1. Prepare: audit the plan against the codebase.
  2. Execute: make the bounded change.
  3. Review: compare the result to what Prepare predicted.

PER is heavier than SOAR. Use it when the work has enough uncertainty that you want an explicit gate before execution.

Before closing a task or goal:

Terminal window
exo verify

Then record the result:

Terminal window
exo task complete <task-id> --log "What is now true"

For a completed goal:

Terminal window
exo goal complete <goal-id> --log "What shipped and how it was verified"

Completion pauses for outcome review. That is where the human decision belongs: the agent can claim the work is done, but the user records that it is done.

If you come back after a break, do not ask the agent to remember. Ask the project:

Terminal window
exo status
exo map
git status --short

If the working tree is dirty, inspect before acting:

Terminal window
git diff

Then either continue the active task, commit the finished work, or ask Exosuit to orient you again. The project should carry the thread, not the previous chat.