Open your first agent session

Before you start

Open a project and choose the agent CLI you want to use. Complete that provider's own sign-in or API-key setup before sending it a task.

Start the agent

Open Settings ▸ Providers and enable the coding CLIs you use. Saggar uses that roster to fill the new-session menu; it never installs a provider without asking.

Open Provider settings

Return to a project, open the ＋ menu, and select an agent. A session opens in the project directory and starts the provider. Starting the CLI yourself in a plain session works too.

Check that it works

When Saggar recognizes the process, the session gains an agent label and begins reporting Needs you, Working, Idle, Finished, or Failed. Provider hooks can make those signals more exact. They are optional and managed from Settings ▸ Providers.

Send a small request, such as "Describe this project without changing any files." Check that the session shows an agent label and responds to the request. The exact status signals depend on the provider and its installed hooks.

If the CLI won't start or its status isn't updating, follow the agent checks in Troubleshooting.

Next steps

Continue with Agents for recognition and hooks, then Managing parallel agents when you are ready to run more than one session.