Granular Granular

Sessions and projects in Granular

In short

A session is one chat-plus-terminal workspace; a project groups related sessions and files. Here is how they fit together.

Updated 2026-06-29

What is a session?

A session is a single workspace pairing a chat with a real terminal, pointed at one folder on your Mac. It remembers your conversation, the work done, and where you left off — so you can close Granular and pick up later exactly where you stopped.

What is a project?

A project groups related sessions and files under one home folder. Use a project per initiative — a brand, a client, a product — so its work, history, and context stay together and separate from everything else.

Sessions remember everything

Granular persists each session's transcript, scrollback, and working folder, and self-heals when you reopen it. Your context is never lost between visits.

Frequently asked questions

How many sessions can I run?
Free plans include a starter number of sessions; Pro raises the limits. You can run several at once, each in its own workspace.
Can two sessions share files?
Sessions in the same project share that project's folder. Separate projects stay isolated.

Related

Your first session in Granular
Start a session, chat your goal in plain English, and watch an AI agent do the work in a real terminal. Here is exactly what to expect the first time.
Boss and worker agents: running several agents at once
In Granular you can promote a session to a boss that delegates tasks to worker agents running in parallel, each in its own isolated copy of the project.
Branch sessions with git worktrees
Branch sessions let you try work in an isolated copy of your project using git worktrees, so experiments never disturb your main copy until you choose to merge.