The Cockpit
The cockpit is the local web GUI for your workspace. It drives this repo through the Claude Agent SDK — so the agent has the same skills, governance, and sync that your terminal does, with a friendlier surface on top.
npm run gui -- --repo ~/Projects/your-workspacePick your model — and switch anytime
Section titled “Pick your model — and switch anytime”The chat header has a model picker with two options:
- Sonnet 4.6 — the default. Fast and cheap; the right choice for most work.
- Opus 4.8 — for harder reasoning.
You can switch mid-session with no reconnect — the new model applies to your
next message. Your choice persists to agent_model in aios.yaml.
Resumable Chats
Section titled “Resumable Chats”Every conversation is saved. The Chats sidebar lists them newest-first, titled from each chat’s first message. Reopen one to replay its transcript and resume the same session; hit + New chat to start fresh. The cockpit reopens your last chat when you reload.
Context (est.) meter
Section titled “Context (est.) meter”A small context (est.) meter shows roughly how much of the model’s window
your last turn used (e.g. ~45k / 200k). It’s an estimate — a per-turn proxy,
not a live running total — so you can tell when a chat is getting heavy.
Markdown replies
Section titled “Markdown replies”Assistant replies render as GitHub-flavored markdown — tables, lists, and code — not raw text. Links open in a new tab.
Personality
Section titled “Personality”Open Settings → Personality to choose the agent’s voice:
| Personality | Voice |
|---|---|
| AIOS (default) | Calm, structured, governance-aware |
| Analyst | Rigorous and cited — weighs evidence, hedges honestly |
| Coach | Warm and encouraging — asks sharp questions |
| Operator | Terse and action-first — answers, then next steps |
Skills
Section titled “Skills”The Skills tab installs official Anthropic skills, vendored from
anthropics/skills and hash-locked to a pinned upstream commit. All are
Apache-2.0.
Installing copies the skill into .claude/skills/ so the agent can use it —
behind an integrity check, a collision guard, and an append-only install ledger.
Removal is safe-only: it won’t delete a skill you’ve edited locally.
The vendored set:
- skill-creator — build and improve skills
- mcp-builder — build MCP servers
- web-artifacts-builder — build self-contained web artifacts
- claude-api — Claude API / Anthropic SDK reference
- frontend-design — guidance for distinctive UI
Document skills point to Claude
Section titled “Document skills point to Claude”Anthropic’s document skills — Word (docx), Excel (xlsx), PowerPoint
(pptx), and PDF (pdf) — are proprietary and Anthropic-hosted, so they are
not copied into your repo. They appear under Documents — available in
Claude with an Enable in Claude ↗ link. Use them inside Claude rather than
installing them here.
Community skills are scanned before install
Section titled “Community skills are scanned before install”Skills from beyond the official library are installed through a community
trust tier: before anything is copied in, a static safety scan reads the
skill’s SKILL.md and every bundled file and flags bundled code (including
extensionless shebang scripts), network calls, secret reads, external URLs, and
prompt-injection — showing each finding as file:line. You review the findings
and consent before install; a high-risk skill requires a typed confirmation.
Marketplace skills (first-party)
Section titled “Marketplace skills (first-party)”The marketplace tier installs first-party Anthropic skills from
claude-plugins-official via fetch-on-install: the skill is fetched at a pinned
repo@commit and its bytes are verified against a declared hash before anything is
copied in (install is refused on mismatch). It sits between official (vendored,
one-click) and community (scanned, typed-consent) in the trust order.
Onboarding: draft your profile from a link
Section titled “Onboarding: draft your profile from a link”On first run, the cockpit can set up your profile for you. Under or draft it from a link, paste a company or profile URL and click Draft →.
The agent reads that one page with the firecrawl-direct skill (via
Firecrawl) and extracts structured facts — who you are, your company, your focus
areas, the tools you use — then drafts your durable memory
(.claude/memory/USER.md + WORKSPACE.md). You confirm before anything is written.
It also matches the tools it detected to connectable integrations and offers to connect them in the Integrations tab — advisory, and only ever for integrations that can actually be connected. It never connects anything for you.