apra-fleet Files

What's new in v0.1.6

First-run onboarding experience (#101)

New users now get a guided introduction the first time the MCP server responds to a tool call:

• ASCII welcome banner with a getting-started guide on first use
• Contextual nudges at three key journey points: after registering the first member, after dispatching the first prompt, and when a multi-member fleet is running
• Welcome-back message on server restart when an active fleet is already registered
• wrapTool() central wrapper replaces 21 inline wrappers — consistent entry/exit handling across all tools
• Onboarding state stored at ~/.apra-fleet/data/onboarding.json (atomic writes, upgrade-safe)
• Existing users on upgrade get a one-time upgrade nudge rather than the full first-run flow
• 57 new tests (658 total)

README rewrite — leads with doer-reviewer workflow (#133)

The README was substantially rewritten to lead with what makes apra-fleet useful:

• Repositioned tagline: opens with the doer↔reviewer loop rather than generic "fleet manager" copy
• Single-machine quickstart: step-by-step from install to first delegated task on one machine
• One-liner install prominently featured for all platforms (macOS/Linux/Windows)
• Provider recommendations table: which LLM to pick for which role
• FAQ section — 8 collapsible Q&As drawn from community discussions (#127): cost, model choice, single-machine vs. multi-machine, Windows support, and more
• docs/FAQ.md added for AI agent consumption, with llm-context / keywords / see-also frontmatter
• LLM context hints (<!-- llm-context --> comments) added to 8 doc files so agents navigating the repo get better orientation
• README tool table synced with CLAUDE.md

Install UX, bug fixes & doc consolidation (#143)

Closes [#115], [#108], [#39], [#96], [#139], [#142], [#140], [#136], [#134]

Install UX

• apra-fleet install --help / -h now prints usage and exits — no files written (#142)
• Bare apra-fleet install defaults to --skill all (installs both fleet and pm skills) (#139)
• --skill fleet, --skill pm, --skill none, --no-skill flags for fine-grained control (#139)
• Running-server guard: install exits with a hint to use --force when the MCP server is active (#96)
• --force kills the running server and proceeds with reinstall (#96)
• Unknown flags (--typo, etc.) are rejected with a clear error message (#96)

Bug fixes

• Unknown llmProvider values now throw TypeError instead of silently using Claude behaviour (#115)
• Codex config.toml now writes defaultModel = "gpt-4o" (properly quoted) instead of a bare unquoted value (#115)
• Claude session resume uses -c flag instead of --resume <session-id> (#108)
• Statusline cleared (file emptied, state reset to {}) when the last fleet member is removed (#39)

Doc consolidation

• docs/user-guide.md absorbed into readme.md — 20 sections merged with <details> collapsibles (#140, [#136])
• CLAUDE.md and AGENTS.md rewritten as thin wrappers (≤ 30 lines each) pointing to readme.md (#140)
• llms.txt updated to reference readme.md (was docs/user-guide.md) (#134)
• scripts/gen-llms-full.mjs updated to source from readme.md (#134)
• All stale user-guide references removed from .md, .ts, .js, .json, .yml files (#136)

Full changelog: https://github.com/Apra-Labs/apra-fleet/compare/v0.1.5...v0.1.6

What's Changed

• docs: rewrite README to lead with doer-reviewer loops and add FAQ by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/133
• feat: first-run onboarding experience and user engagement nudges by @mraduldubey in https://github.com/Apra-Labs/apra-fleet/pull/101
• feat: Install UX, bug fixes, docs & doc consolidation by @kumaakh in https://github.com/Apra-Labs/apra-fleet/pull/143

Full Changelog: https://github.com/Apra-Labs/apra-fleet/compare/v0.1.5...v0.1.6