coding agents

overview

atlas has first-class support for running coding agents inside your workspaces. agents run in dedicated terminal tabs scoped to the workspace directory.

built-in agents

• claude code — launches with claude --session-id {session_id}, resumes with claude --resume {session_id}
• codex — launches with codex, resumes with codex resume --last

you can also configure custom agents in settings — any cli tool that runs in a terminal works.

launching an agent

from the workspace view, open the agent launcher and pick an agent or enter a custom command. atlas opens a dedicated terminal tab for the agent, running in your workspace’s worktree directory.

each agent session gets a unique id so it can be resumed later.

agent notifications

atlas monitors agent output for prompts that need your attention — like confirmation dialogs or input prompts. when detected, you’ll get:

• a toast notification in-app
• an os notification
• an optional sound alert (configurable)

this means you can work in another workspace while an agent runs, and atlas will let you know when it needs input.

session persistence

when you restart atlas, agent sessions can be restored using their saved restore command. for example, claude code sessions resume with --resume {session_id}, picking up where you left off.

custom agents

in settings, you can add your own agent configurations with:

• name — display name in the launcher
• command — the program to run
• launch args — arguments for first launch (supports {session_id} placeholder)
• restore command — command to resume a previous session

any cli-based coding tool works — opencode, aider, or your own scripts.