Projects & Sessions

The agent organizes work into projects and sessions:

• Project — a directory on your machine. Sessions in a project work within that directory's scope.
• Session — a conversation thread where messages, tool calls, and generated files are kept together.

Projects

Creating a Project

In the agent sidebar, open the Projects column, enter a name and a filesystem path, and press Enter. The CLI checks that the path exists before creating the project.

The agent can read and write files and run shell commands within the project directory. Each project keeps its own sessions, so work stays organized by codebase.

Studio Binding

You can link a local project to an Aexol Studio project from the project controls or with spectral bind. This makes the linked Studio context and remote tools available while you work locally. See Studio Binding for setup and troubleshooting.

Sessions

Creating a Session

Select a project and click + New Session. The new conversation is immediately associated with that project.

Session Lifecycle

• Messages and tool activity persist across browser refreshes and machine restarts.
• The agent gives a session a title after the first assistant response; you can rename it later.
• Use Fork & Compact to start a focused conversation from an existing session while carrying forward its useful context.
• Delete sessions you no longer need from the session list.

Reconnecting to a Session

If you disconnect during a response—for example, by closing the browser—the agent continues working locally. When you reconnect, the current session catches up with the recent response, tool calls, and results.

You can safely open the same session in multiple browser tabs. Updates from one tab appear in the others.

Next Steps

• Prompt Quality
• Managing Machines
• Observational Memory