Skip to main content
Continuum spawns the claude CLI in a per-session direct PTY. No proxy, no middleware — the session is a real terminal connected to claude.

​
Requirements

The claude CLI must be installed and logged in. Continuum reads Claude Code’s own OAuth token from ~/.claude/.credentials.json and the local Keychain (KeychainTokenProvider). You do not paste a key into Continuum on Mac.

​
Session modes

ModeBehavior
Plan modeSpawns claude with plan-mode flags. Agent proposes a plan before executing. Approve from Mac, iPhone, or Watch.
Accept-editsClaude applies file edits automatically within the session’s working directory.
Bypass modeSkips confirmations. Gated by per-repo trust in AutopilotState.
Switching mode mid-session re-spawns claude with the new flags in the session’s current working directory.

​
Session resume

Continuum reads the Claude session ID from the JSONL header and can resume a prior session with --resume <id>. Right-click a recent JSONL row in the sidebar and choose Continue here to open a continuable session pinned to the same file.

​
Rate-limit gauge

The Usage tab shows a live rolling quota gauge for Claude. Continuum polls rate-limit headers returned by Claude Code’s own API calls and reads local auth state from the Keychain and ~/.claude/.credentials.json. No additional token or credential is needed on Mac. On iPhone, the OAuth token mirrors via iCloud Keychain when the Mac publishes it, or you can paste a token in Settings as a fallback (PastedAnthropicTokenProvider). A soft-red weekly cap badge appears in the chat composer footer when usage reaches 95% or more of the weekly rolling limit. Codex sessions do not show this badge because Anthropic’s weekly cap does not apply to Codex.

​
Usage analytics

Token events are parsed from ~/.claude/projects/**/*.jsonl. Each record is deduplicated by messageId:requestId (matching ccusage behavior), priced with the embedded LiteLLM snapshot, and rolled up by day and repo in the Usage tab. The ccusage daily command is the parity benchmark. If Continuum’s numbers diverge from ccusage, ccusage is treated as the ground truth.

​
Slash-command skills

Typing / in the chat composer opens a palette. Continuum walks these locations for skill definitions:
  • ~/.claude/skills/<name>/SKILL.md — global skills
  • <repo>/.claude/skills/<name>/SKILL.md — project-local skills
The walk runs on a background thread with a 30-second TTL and directory-mtime invalidation. The palette never blocks the main thread.

​
Auto-revive

Claude Code’s 5-hour OAuth session can expire mid-work. Continuum’s AutoReviver keeps the session warm. See the auto-revive documentation for details.

​
iPhone auth

The Mac mirrors the OAuth token to iCloud Keychain on launch. If iCloud Keychain sync is unavailable (personal Apple Developer account), go to iPhone Settings and paste a token manually.