v0.9 · MIT · local-first

Plan it. Learn every feature. Run it as a crew.

Adeptly turns a sentence into a full plan — with the right Claude Code features baked into every section. Then it runs the plan, scores how lean it is on tokens, and shows what you spent. All on your machine. No API key, no backend, no telemetry.

0
Claude Code features, catalogued
0
API keys · backends · accounts
0
local — code never leaves your box
0
crew roles, dry-run by default
The gap

You're paying for Claude Code.
You're using a sliver of it.

Plan Mode, subagents, skills, hooks, MCP, auto-memory — most people never find them. And when a few devs share a repo, nobody knows the plan until the PR lands. Adeptly closes both gaps.

~15%

of Claude Code, actually used

Adeptly names the exact features your plan should use — inline, with hover explanations — so you learn them by reading your own plans. A live Coverage score makes it measurable.

$0

new trust surface

Adeptly is a thin GUI over your local claude CLI. Plans live as markdown in git — that's the whole team-sync model. Nothing new leaves your machine.

The loop

A sentence in. A pull request out.

One plan-first workflow — and you can stop, hand off, or take over at any step.

💬
Describe
say what to build
🗺️
Plan + Recipe
features named inline
Approve
draft → approved
👥
Crew
build · test · review
🚀
PR
branch pushed
What makes it different

The only tool that explains Claude Code — and runs it.

Learn by reading your own plans

Every feature, named where it belongs

Adeptly writes the plan and underlines the exact Claude Code features to use — right in the sections they apply to. Hover any one for what it is and why it's here. Nobody else explains Claude Code like this.

  • Plan Mode, subagents, skills, hooks, MCP, /security-review, auto-memory — all in context
  • A numbered suggestion strip: "line 19 → /security-review matched 'password'"
  • A 30+ feature catalogue you can refresh from your own CLI
docs/plans/passkeys.md

Add passkeys to the auth flow

Start in Plan Mode before writing code — the change spans sessions and middleware.

Map the current flow with an Explore subagent, then implement behind a flag.

Run /security-review before merging the session-token changes.

Plan ModeExplore/security-review+ hover to learn
Coverage · Token Hygiene

Measure how much you use — and how lean you spend

Two scores over your plan: how many Claude Code features it actually uses, and how many money-saving habits it follows. Each gap is one click to bake into the plan.

  • Coverage: using 6 / 34 features — with the high-value ones you're missing
  • Token Hygiene: Plan Mode first, Explore for search, cache-friendly ordering, Haiku for grunt work
  • One click adds the recommendation straight into the plan
coverage · this plan
Coverage19%
Hygiene75%
Cost est.~$0.20
Hooks (PostToolUse) — auto-run tests + add
MCP — you mention a Postgres DB + add
Usage ledger + whole-account

See exactly what Claude is costing you

Every call Adeptly makes records its real token cost and cache-hit. Flip to Whole account to see machine-wide spend parsed from ~/.claude — tokens exact, cost estimated. 100% local, no telemetry.

  • Spend, cache-hit %, and cost by source & model
  • Recipe shows an upfront estimate; the crew shows estimate-vs-actual
  • A daily-cost sparkline across every session
whole account · 30d
94%cache hit2.4Mtokens14sessions
The whole kit

Everything, keyed off your own claude

Fifteen more reasons it stays open in a tab all day.

v0.9 · new
🚦

Delegate

Split a plan across parallel sessions. Each brief carries the same Working Agreement and its own file lane — so two Claude tabs don't collide or skip the safety checks.

v0.5
👥

Crew runner

Runs an approved plan as roles — Architect → Builder → Medic → Reviewer + Security (parallel) → PR. Dry-run by default; live is double-gated.

v0.8
🤝

Session handoff

Leave a resume note one Claude session hands to the next — the bridge sessions can't make live.

v0.7
🔄

Refresh from your CLI

Ask your own self-updating claude what features are new and fold them in. No backend, no doc-scraping.

v0.6
🧩

Stack-aware recipes

Detects your stack from manifests so every recommendation, path, and command fits what you actually build with.

v0.8
🕘

Run history + re-run

Browse every past crew run — mode, pass count, cost, PR — and re-run any of them in one click.

Approvals in git

Plans and approval state are files. Every dev sees the same thing; git is the only sync layer. No accounts.

🎙️

Voice + vision

Dictate in chat (push-to-talk) or paste a screenshot and ask Claude to read it.

v0.8
🌐

Remote & tunnel

--host for LAN, --tunnel for a Cloudflare quick-tunnel — with a loud, honest trust warning.

Recipe generator

Structured workflow for a plan: subagents by purpose, skills with when-to-invoke, hooks, expected turns & cost.

Command palette

⌘K to search and open plans, ⌘I for chat, focus mode to hide the panels.

🔀

Multi-dev aware

The plans list shows git author + dirty-state, so you see who last touched what at a glance.

📋

Copy as prompt

One click turns plan + recipe into a paste-ready Claude Code prompt for a fresh session.

🌗

Dark & light

Drag-resize splitters, a mint-green pulse when a plan gets approved, and both themes done right.

🔒

Audit trail

Every crew run is written to runs/<slug>/ as JSON + an append-only audit.jsonl.

Why Adeptly

Not another code generator

Cursor, Continue, and Aider generate code. Adeptly starts one step upstream — the plan that becomes a great prompt — and closes the loop with a crew that runs it.

CapabilityAdeptlyRaw Claude CodeCode-gen IDEs
Plan-first, approve before codemanual
Teaches every Claude Code feature inline
Coverage + token-hygiene score
Shows your real token spend
Runs the plan as a role crew → PRDIYpartial
Team sync with zero backend (git)
Runs locally, no API key of its ownvaries
The trust moat

Your code never leaves your machine

No SaaS backend, no API key, no telemetry, no account. If you trust Claude Code, Adeptly adds zero new trust surface.

WhatWhere it runsWhat it sends
Adeptly web UIlocalhostnothing
Adeptly node serveryour boxnothing
claude --print subprocessyour boxyour prompt → your CLI → Anthropic, exactly as if you typed it
Momentum · live from npm

Developers are already shipping with it

Pulled live from the npm registry and GitHub right now — no marketing math, just the real counters.

total installs
last 30 days
GitHub stars
daily installs · last 30 days
Get started

Two commands. That's the whole setup.

Needs Node 18.17+ and a signed-in Claude Code CLI.

$npm i -g @anthropic-ai/claude-code && npx adeptly