Projects and sessions

A project is a directory, normally a Git repository. It provides the home for terminals, shared commands, jobs, notes, documentation, and project-local settings.

A session is one real terminal. It has its own shell process, working directory, transcript, status, agent identity, and Git context. A session can belong to a project or remain unassigned.

Projects organize durable intent; sessions represent running work. Closing the window does not flatten those into a list of commands. Saggar records enough workspace state to restore the arrangement while keeping live process work in the terminal layer.

See Projects and terminals for the controls and Project storage for the files involved.