v0.9.0 — Delegate

Delegate — split work across parallel Claude Code sessions, safely.

Running two sessions on the same repo means inconsistent rigor (the driver session skips the concern/security check the delegated one does) and file collisions. v0.9 fixes both.

🤝 Working Agreement

A per-project pre-flight gate (.adeptly/agreement.md): restate scope → surface concerns → state security impact → confirm approach → smallest diff → stay in your lane. Adeptly staples it onto every brief and every "copy as prompt", so every session — driver included — runs the same checks.

✂️ Splitter + lane briefs

Turn an approved plan into N independent subtasks via your own claude, divided by area so they touch disjoint files. Each subtask becomes a paste-ready brief: scope + the Agreement + "other sessions own these files, stay out." Drop one into each terminal tab.

🚦 Collision guard + board

Flags any file claimed by two subtasks, shows dependency order, and tracks todo / in-progress / done so tabs don't duplicate work.

Open the Delegate tab on an approved plan. All local — no backend, same trust model.

---

npm install -g adeptly@0.9.0   # or: npx adeptly

v0.8.1 — Handoff, whole-account usage, run history, tunnel, parallel crew

v0.8 lands five features, each shipped as its own PR (#1–#5) and merged to main.

🤝 Session handoff (#1)

Claude Code sessions can't talk live — leave a handoff note (done / next / branch / plan) and Copy resume prompt into a fresh claude session to continue without rebuilding context.

📊 Whole-account usage (#2)

The Usage panel gains a Whole account view: parses every transcript under ~/.claude for machine-wide token usage, estimated cost, cache-hit, by-model, and a daily-cost sparkline. Tokens exact, cost estimated. 100% local.

🕘 Crew run history + re-run (#3)

Browse every past crew run for a plan (mode, pass count, time, cost, PR) and re-run any of them in one click.

🌐 Remote / tunnel (#4)

adeptly --tunnel exposes the app via a Cloudflare quick-tunnel with a loud "anyone with this URL can drive your claude" warning, plus clearer --host security guidance.

⚡ Parallel crew stages (#5)

Reviewer + Security review the diff concurrently (both advisory + independent), so live runs finish sooner.

---

Install:

npm install -g adeptly@0.8.1   # or: npx adeptly

Note: 0.8.0 shipped a broken tarball (missing the standalone server) and was immediately deprecated and superseded by 0.8.1. Use 0.8.1.

v0.7.0 — Usage, Coverage & Token Hygiene

See your usage, spend less. v0.7.0 adds three pillars for getting more Claude Code for less — all local-first, all keyed off your own claude CLI.

📊 Measure — usage ledger

Every claude call Adeptly makes (recipe, crew, feature-refresh) now records its real token/cost receipt (--output-format json) to .adeptly/usage.jsonl. The new Usage panel shows spend, cache-hit %, and cost by source & model, over 7d / 30d / all-time. No telemetry — the ledger never leaves your machine.

💰 Estimate — cost up front

The recipe's expected turns + cost are surfaced, and the Crew shows estimate vs. actual after a live run.

🌿 Optimize — Token Hygiene (Savings tab)

An efficiency score for the plan against the money-saving Claude habits — Plan Mode first, Explore subagent for search, /clear, cache-friendly ordering, Haiku for mechanical work, background agents, fewer permission prompts. Each missing habit is one click to bake into the plan.

🎯 Coverage

Every plan scored on how many of Claude Code's 30+ features it actually uses, with the high-value gaps (and why) — one click to add each. The core pitch, made measurable.

🔄 Refresh the catalogue from your CLI

The built-in feature list is a snapshot that goes stale. Hit Refresh and Adeptly asks your own (self-updating) claude CLI what's new, validates + de-dupes it, and lets you accept additions into .adeptly/features.json. No backend, no doc-scraping.

---

Install / upgrade:

npm install -g adeptly@0.7.0   # or: npx adeptly

Full parity with npm adeptly@0.7.0.

v0.6.0 — Stack auto-detection

🧭 Stack auto-detection

Adeptly now reads your project's manifests — package.json, go.mod, Cargo.toml, requirements.txt/pyproject.toml, composer.json, Gemfile, pom.xml/build.gradle, Dockerfile — and feeds the detected stack into the plan, refine, and recipe prompts.

So the recommendations, file paths, libraries, and commands now fit the stack you actually build with. A "Tailored for your stack" chip in the recipe panel shows what it detected (e.g. TypeScript · Next.js, React · Prisma, Tailwind · pnpm).

Shipped from a real user request on r/ClaudeAI — thanks Due_Ad5532.

npx adeptly

v0.5.2 — One source of truth for the plumbing

🧱 De-duplication

Removed three sets of copy-pasted logic a reviewer would rightly flag:

• Claude CLI wrapper (was in 3 files) → lib/claude-cli.ts
• LLM-JSON extraction (3 near-identical parsers) → lib/llm-json.ts extractJson()
• child_process spawn/capture (git + crew) → lib/exec.ts capture()

No behavior change. Type-check + build green, crew dry-run 7/7.

v0.5.1 — Cleaner prompt building

🧹 Readability fix

Refactored the chat prompt builders from ~30 sequential lines.push() calls into single template literals. Same output, far more readable. No behavior change.

Thanks to the r/ClaudeAI commenter who flagged it.

v0.5.0 — Crew runner + open source

🚀 Crew runner

Execute an approved plan as a role pipeline — Architect → Approval Gate → Builder → Medic → Reviewer → Security → Pilot — each a headless claude turn in your own repo.

• Dry-run by default; live runs require ADEPTLY_LIVE=1 and an approved plan.
• 100% local. Your code never leaves your machine.

Also: open-source scaffolding (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, issue/PR templates, CI), README badges + roadmap. Repo is now public.

npx adeptly