Changelog

A running history of changes to the Autohand documentation site.

2026-09-27

• Added integrations/coding-agents/ with an overview and step-by-step guides for using Fantail and Moa from Codex, Claude Code, Pi, Hermes Agent, OpenCode, Kilo Code, Cline, Factory Droid, and Aider, including sub-agent model settings. Added the group to the Integrations sidebar and the integrations directory.
• Fixed unattended CI and container examples in working-with-autohand-code/headless-mode, guides/ci-cd-automation, recipes, cli-quick-start, security-best-practices, git-flow-automation, integrations/github, integrations/bitbucket, and the automation tutorials: runs now use --bare with AUTOHAND_PROVIDER, AUTOHAND_AI_API_KEY, and AUTOHAND_API_KEY, and create ~/.local/bin before installing.
• Switched tutorials/run-autohand-on-a-vps, run-autohand-on-aws-ec2, and run-autohand-on-digitalocean to autohand login with the Fantail and Moa models.
• Replaced the cropped Console and Autohand Dev screenshots in getting-started/console, agent-sdk/api-key-setup, and guides/autohand-dev with full-width captures.

2026-09-26

• Aligned command-mode docs with the CLI source: removed the nonexistent --headless, --skill, --tools, --new, --session, --sandbox, --daemon, and autohand run usages across working-with-autohand-code/headless-mode, pipe-mode, cli-reference, skills, guides/ci-cd-automation, recipes, security-best-practices, cli-quick-start, automation/building-event-driven-agents, the nine guides/skills/* pages, and the automation tutorials.
• Documented the real JSON output: --json local prints {"type":"result","content":...} or {"type":"error","message":...}, --output-format accepts only stream-json, and plain piped runs print text. Updated jq examples to read .content.
• Rewrote working-with-autohand-code/yolo-mode for tool-name patterns (allow: or deny: plus tool names), noted that --timeout is not enforced yet, and pointed command limits to permissions.denyList and allowList.
• Added --allowed-tools, --disallowed-tools, --ephemeral, --max-requests, --max-tokens, and --max-duration to cli-reference and headless-mode; replaced session flags with autohand sessions, autohand resume, and --fork.
• Fixed the npm package name to autohand-cli in integrations/github and guides/troubleshooting, removed unread environment variables and config keys, and replaced invented settings sections in integrations/github and integrations/bitbucket.
• Rewrote guides/git-flow-automation around real worktree features (--worktree, --tmux, auto-mode, agent teams, and the git_worktree_* agent tools) and removed the nonexistent autohand parallel commands.
• Fixed working-with-autohand-code/agent-teams examples that used --team 3; teams now start from a prompt that names the teammate count.

2026-09-22

• Added working-with-autohand-code/agent-traces and tutorials/set-up-agent-traces with installer, consent, supported-agent, Work Map, Console, Team, and deletion guidance.
• Linked agent traces from the CLI overview, telemetry reference, tutorials index, Team plan, and shared sidebar navigation.
• Marked Weka 1.0 as a Public Preview available through the Autohand API, SDK, and Console Playground.
• Expanded the Weka guide with the full JevBench v1.2.2 comparison while retaining the deployed Jev provider and response contract.
• Grouped Overview, Fantail, Moa, and Weka under one expandable Models section in the docs sidebar and restored the Fantail and Moa model reports.
• Documented why Weka uses the named Jev AI Gateway path: Cloudflare Dynamic Routes currently require chat completions and cannot preserve Jev's typed request contract.
• Completed the Weka response contract examples with every requested answer and token usage, added TypeSafe AI and RLCD provenance, and documented Autohand's non-empty question and criteria validation.
• Corrected models/weka to match Jev's state contract: top-level strings, numbers, booleans, objects, arrays, and null are accepted, with recursive JSON values inside structured state.
• Added guides/manage-team-members with Team trial acceptance, seat, invitation, role, removal, ownership, and API behavior, plus two short privacy-safe Console GIFs.
• Linked Team member management from the guides index, shared navigation, and Team plan reference.

2026-09-21

• Added the Weka model guide with typed request and response contracts, release gate, incident triage, and agent workflow tutorials, rendered Mermaid diagrams, Console Playground steps, JevBench results, and shared quota behavior.
• Added Weka to model navigation, the model overview, and paid plan availability while documenting that it runs through the API and Console rather than the CLI.

2026-09-19

• Optimized site-wide syntax highlighting with visible, on-demand Shiki language chunks and the JavaScript regex engine, and added bundle budgets to prevent full-grammar or WebAssembly regressions.
• Rebuilt the docs home and getting-started/first-session as a Web-first, outcome-led journey across browser, CLI, editor, mobile, and SDK surfaces, with mobile Home Screen and plan guidance.
• Marked docs-md Markdown mirrors as non-indexable while preserving crawl and AI retrieval, and added discovery and onboarding regression coverage.
• Normalized generated Markdown whitespace and removed decorative onboarding numbers from assistant-facing exports.

2026-09-18

• Updated guides/playground for the multi-window comparison workbench, grouped SDLC examples, per-window controls, and active-window History and SDK workflows.
• Added three short Playwright walkthroughs and refreshed privacy-safe screenshots for comparing models, restoring 30-day history, and copying syntax-highlighted SDK code.
• Added responsive manual video styling and media contract tests for the new Playground walkthroughs.

2026-09-17

• Added guides/manage-autohand-code-account, guides/playground, and guides/autohand-dev as screenshot-led user manuals for Console account controls, the 30-day Playground workflow, and the Dev browser composer.
• Added a dedicated account and web-workspace block to guides/index and linked the three manuals from DocsLayout.vue.
• Added privacy-safe production captures for Playground history, syntax-highlighted SDK examples, Account controls, and the Dev composer.

2026-09-10

• Rewrote working-with-autohand-code/hooks to document the CLI's lifecycle hook model: the hooks.hooks array shape, definition properties, filter and matcher rules, every event from the CLI catalogue (including permission-denied), the $HOOK_* environment variables, JSON stdin, control-flow responses and exit codes, template variables, a legacy event-name mapping table, and examples using pre-tool deny decisions.
• Converted working-with-autohand-code/hooks-and-events and guides/automation/hooks-and-events examples to the array shape with file-modified path filters and pre-tool guardrails, updated the event category table to current names, and linked the legacy name mapping.
• Updated the /hooks entry in working-with-autohand-code/slash-commands and the hook event list in guides/ace/best-practices to current event names.
• Protected literal template placeholders in hook pages with v-pre so Vue no longer strips them at render time.

2026-09-09

• Added guides/peer-communication, guides/peer-resource-coordination, guides/peer-communication-protocol, and tutorials/peer-communication-lab with configuration, terminal workflows, tool contracts, security, persistence, process ownership, limits and recovery; linked them from the shared sidebar and peer/guide indexes. Added peer configuration and required ports/transports to the configuration reference.

• Aligned the global navigation with the main site: Products, What we solve, Developers, Organisations, Resources and Pricing; preserved matching-domain links and mobile menu access.

2026-09-08

• Fixed CopyPageMenu.vue so Open in Autohand opens the Dev composer with an editable prompt containing the current documentation page URL on either docs domain.
• Added the shared site categories, matching-domain home logo, Pricing, and Sign up to DocsLayout.vue; moved documentation topics into separate labeled navigation.
• Improved code syntax contrast in both themes and made scrollable code samples keyboard focusable.
• Fixed mobile navigation focus, collapsed sidebar state, skip links, search keyboard behavior, feedback and copy-menu focus, visible focus, and dark-theme text contrast in the shared documentation layout.
• Updated getting-started/plans-and-pricing and its related pages to match current hosted credit allowances, per-member Team limits, annual billing, and paid hosted SDK/API access.

2026-09-06

• Updated agent-sdk/io/step-control with cancellation guarantees, bundled-CLI provenance, installed-package checks, and the distinction between post-tool stopping and pre-tool approvals.
• Highlighted the TypeScript development update in agent-sdk/overview and agent-sdk/typescript without announcing an unverified package release.
• Documented validated rate-limit events and explicit session-retry behavior in agent-sdk/concepts/hooks-and-events, agent-sdk/typescript-api, and working-with-autohand-code/hooks-and-events; added documentation contract tests.
• Added scripts/audit-doc-discovery.mjs and scripts/verify-learning-labs.mjs to verify public discovery coverage, code-export parity, new-page links, and the learning fixture's passing and failing checkpoints.
• Fixed Markdown cleanup that removed C++ lambda parameters, escaped the XML sample in guides/java-modernization, preserved known publication dates, and aligned modification metadata on models/fantail/index and models/moa/index.
• Added guides/explore-a-codebase, guides/task-prompts, guides/context-and-handoffs, guides/permissions-and-safe-execution, guides/monorepo-workflows, guides/reliable-automation, and guides/ai-documentation with examples, checkpoints, and visible FAQs.
• Added tutorials/learning-paths/index, tutorials/learning-paths/setup-practice-project, tutorials/learning-paths/fix-a-bug, tutorials/learning-paths/add-a-feature, tutorials/learning-paths/review-and-handoff, and tutorials/learning-paths/automate-a-check with a downloadable task-list fixture and independent exercises.
• Linked the workflow guides and self-paced labs from guides/index, tutorials/index, and DocsLayout.vue; added direct introductory definitions to working-with-autohand-code/cli and working-with-autohand-code/agent-skills.
• Updated site-wide SEO metadata with Markdown encodings, LLM index links, visible FAQ support, and consistent modification dates; excluded redirect pages from discovery.
• Fixed scripts/generate-markdown.mjs to retain Vue code examples, resolve source links, and generate descriptive llms.txt, llm.txt, and llms-full.txt exports.
• Added static code examples to built HTML through vite.config.js and repaired malformed examples in tutorials/add-integration-tests and agent-sdk/tools/mcp.
• Corrected literal code bindings in guides/first-project, tutorials/add-integration-tests, and tutorials/build-mobile-app so examples render without Vue expression errors.
• Expanded robots.txt discovery references and text response headers for AI documentation exports.
• Added guides/autohand-review for the free public beta, covering interactive, non-interactive CLI, ACP, JSON-RPC, advanced review kinds and options, code and architecture review practice, lifecycle hooks, telemetry, and the local report viewer.

2026-09-04

• Added compiled-CLI demos for session branching, agent-team controls, sub-agent views, and live peer awareness to the relevant command guides, backed by reusable VHS tapes.

2026-09-02

• Replaced Qwen3.6-27B with Qwen3.8-Max, Qwen3.8-Max-0902, and Qwen3.8-27B in the recommended coding models table on models.
• Made models a collapsible navigation section so models/fantail and models/moa are reachable directly rather than only through the models overview.
• Added a plan-availability table to models/fantail and models/moa, and documented the provider-qualified model aliases on models.
• Replaced the Python example on the model pages with the OpenAI-compatible TypeScript client, which is the surface the gateway actually exposes.
• Corrected the stale Autohand Fantail Pro label to Autohand Fantail and linked the model rows on models to their reference pages.
• Added getting-started/console with sign-in, usage, API-key, client, connector, memory, settings, billing, and account-management guidance plus safe Console captures.
• Added agent-sdk/api-key-setup with a server-side API-key lifecycle and TypeScript SDK application tutorial.
• Added Console and SDK API-key setup links to the shared documentation navigation.
• Added guides/usage-and-peers and refreshed working-with-autohand-code/slash-commands for hosted/local model selection, /usage, and /peers.

2026-08-12

• Reworked models around the verified Fantail and Moa runtime contract, with Autohand Code and API usage paths.
• Replaced site-wide documentation typography with local Autohand Sans 400 and applied Autohand Mono to code and syntax components.
• Updated scripts/generate-og-images.mjs to embed Autohand Sans 400 in every text layer and remove obsolete OG assets.
• Made website_blueprint default-off and gated Blueprint links, navigation, routes, and SEO/discovery output in DocsLayout.vue, index, and scripts/optimize-seo-geo.mjs.
• Reworked index into one goal-first journey for Autohand Code, the Code Agent SDK, and extensions, with responsive navigation and Integrations promoted in the resource directory.
• Added compact accessible language tabs, executable run commands, expected output, a completion checkpoint, troubleshooting links, and a two-image Console walkthrough to agent-sdk/quickstart.
• Replaced the static provider comparison in guides/model-selection with constraint-first guidance generated from the shared model-provider manifest.
• Added contextual ranking and neutral loading feedback to Search.vue, including a direct path to the SDK API-key setup.
• Reorganized DocsLayout.vue with a top-level Integrations destination and progressive, task-grouped SDK and integrations navigation.
• Updated scripts/build-changelog.mjs so exact page entries in this changelog can supply trustworthy last-modified metadata before a commit exists.
• Added a real integrations/ landing page with an open directory, availability and credential cues, and clean-route-aware sidebar navigation.
• Added answer-first setup facts, visible FAQs, matching FAQPage schema, and GEO contract coverage across all 25 integration guides.
• Reworked the integrations/linear, integrations/sentry, and integrations/datadog coming-soon presentation into an unboxed status layout.
• Corrected the home Code Agent SDK examples to use AUTOHAND_API_KEY, added Shiki syntax highlighting, and replaced home surface text copy controls with accessible icons.

2026-08-11

• Added the agent-sdk/quickstart API-key flow with Console screenshots, one-time-secret guidance, and AUTOHAND_API_KEY setup, and surfaced the Console link in the home SDK starter.
• Added language and Autohand model selectors with live SDK examples to the documentation home page.
• Refined the documentation home typography and replaced the grid-and-bracket path cards with an open Autohand-specific pathway layout.
• Redesigned the documentation home page with a full-width path-first layout, surface tabs, quickstart actions, and responsive navigation cards.
• Added the getting-started/plans-and-pricing section as twelve dedicated pages: overview, pricing and limits, usage limits, one page per plan (free, pro, max, team, enterprise), provider API, available models, payment methods, and FAQ.
• Documented that the Free plan does not require a credit card, with GitHub account age as the primary eligibility signal and a card on file only as an optional alternative.
• Named the individual tier Autohand Code Pro throughout the plans documentation, replacing the former Premium product name.
• Documented the non-refundable subscription policy and end-of-period cancellation on plans-and-pricing/payment-methods and in the plans FAQ.
• Added a Plans & Pricing navigation section under Getting started in DocsLayout.vue, expanded automatically on any plans page.
• Added DeepSeek V4 Flash to the recommended coding models table in models/index.

2026-07-31

• Reworked tutorials/extensions/authoring-your-first-extension into a Level 100, task-oriented tutorial with prerequisites, learning objectives, troubleshooting, and advanced next steps.
• Added tutorials/extensions/500-atlassian-rovo-integration with a declarative Agent Skill, native Rovo MCP configuration, OAuth and API-token boundaries, write confirmation, verification, Forge separation, and production test guidance.
• Updated the Extensions tutorial index, navigation, and contract tests for the Level 500 Atlassian Rovo integration.
• Expanded tutorials/extensions/authoring-your-first-extension with the built-in $extension-builder fast path, a complete contributed SKILL.md, project-scoped installation, skill invocation, and lifecycle verification.
• Added agent-sdk/concepts/cli-runtime-control with the complete v1.0.4 cross-language control surface for reset, browser handoff, auto-mode, approvals, saved sessions, timed YOLO, MCP, project learning, tool inspection, context compaction, and auto-mode events.
• Updated all CLI-backed language API references, the Agent SDK overview, and navigation to expose native runtime-control method names and the shared protocol contracts.

2026-07-30

• Added agent-sdk/io/step-control and updated the TypeScript API, sessions, and hooks/events docs for stopWhen, concurrent-session awareness, and complete CLI-backed event parity.
• Added working-with-autohand-code/mobile-handoff and updated CLI navigation and /go docs for live steering, durable queues, mobile commands, approvals, exact session resume, and delivery safeguards.

2026-07-29

• Added guides/cursor-alternative with source-backed Cursor AI, Cursor IDE, CLI, pricing-model, and migration comparisons; corrected the Cursor import reference and linked the guide from navigation.
• Fixed social previews across docs pages with complete Open Graph image metadata, correctly sized 1200×630 PNGs, and a regression test for the published image contract.
• Canonicalized production navigation links and moved legacy /docs/*.html handling to one-hop permanent redirects to reduce redirected URL discovery in Search Console.

2026-07-28

• Rebuilt working-with-autohand-code/configuration against the current CLI schema, including config precedence, project overlays, providers, sessions, memory, status-line settings, feature flags, browser integration, and runtime-only controls.
• Updated working-with-autohand-code/extensions, guides/extensions, and extension tutorials for declarative tools, agents, and skills plus explicitly trusted runtime commands, UI, hooks, providers, flags, and permission policy.
• Added guides/extensions/adapt-pi-package and tutorials/extensions/workspace-brief-extension for Pi compatibility and the declarative tool-plus-Agent-Skill pattern.
• Refreshed working-with-autohand-code/cli-reference, working-with-autohand-code/slash-commands, navigation, and collection indexes for structured output, extensions, background process control, announcements, changelog access, and browser-neutral commands.
• Added configuration and extension documentation contract tests covering current CLI fields, trust boundaries, navigation, and shipped examples.

2026-07-21

• Added tutorials/extensions/build-runtime-extension with an end-to-end trusted Extension API v1 build covering slash commands, Ink UI, line segments, shortcuts, flags, hooks, providers, permission policy, trust, daily use, and lifecycle proof.
• Updated Blueprint source-development commands to use the canonical Cargo package and path (blueprint and crates/blueprint) and renamed the source-discovery variable to BLUEPRINT_INDEX_WORKSPACE.

2026-07-20

• Updated the Blueprint manual and product references to use the canonical blueprint command, BLUEPRINT_WORKSPACE with its ~/.blueprint default, blueprint-index skill, and blueprint MCP registration; clarified that non-Git umbrella folders automatically discover separate Git repositories and --no-root skips only a supplied Git root.

2026-07-17

• Added a global Blueprint entry to the DocsLayout.vue top navigation with correct Blueprint and Code active states.
• Updated the home-page product suite with Autohand Code and Code Agent SDK, removed Commander, and staged Squad behind docs_assembly_false.
• Linked the working-with-autohand-code/blueprint product-name note to the EvoGraph research paper.
• Refined the working-with-autohand-code/blueprint introduction to position Blueprint as purpose-built for evolutionary traction.

2026-07-16

• Added the working-with-autohand-code/blueprint user manual covering installation, indexing, search and lineage, Skills and MCP, coding-agent setup, and operations.
• Added Blueprint directly below Evolve in DocsLayout.vue, with expandable links for every manual page.
• Added guides/build-my-company-brain and featured it in the Guides index as an end-to-end multi-repository Blueprint workflow.
• Added tests/blueprint-docs.test.mjs and refreshed generated discovery artifacts for the new Blueprint routes.

2026-07-15

• Added working-with-autohand-code/extensions documentation comparing the Code Agent SDK and CLI extension paths, with lifecycle and Extension API v1 references.
• Added the guides/extensions category covering extension architecture, package design, barebone CLI composition, tools and agents, security, scopes, lifecycle, and distribution.
• Added the tutorials/extensions category with nine detailed builds, including authoring a first extension and recreating all five shipped CLI examples.
• Updated DocsLayout.vue and the Code, Guides, and Tutorials indexes so all extension pages are grouped and discoverable in the shared navigation.
• Added tests/extensions-docs.test.mjs to verify page structure, navigation coverage, build-path guidance, bare-mode boundaries, and the CLI extension contract.
• Refreshed db/seed.sql and generated discovery artifacts with the new extension routes.

2026-07-14

• Gated working-with-autohand-code/assembly navigation, routes, generated discovery files, search, and build output behind the default-off docs_assembly_false flag.
• Added guides/teams-and-swarms user manuals for sub-agents, task-based agent teams, /deep-research, /autoresearch, and 24 orchestration playbooks.
• Added the Orchestrate Team of Agents Guides category, grouping the Sub-agent Catalog and the new orchestration manuals in the sidebar and Guides index.
• Expanded DocsLayout.vue with 24 named playbook links grouped by engineering, operations, research, and optimization instead of a generic use-case link.
• Corrected working-with-autohand-code/slash-commands for the implemented /deep-research contract and linked both new research-command manuals.
• Updated SEO and Open Graph generators to label the teams-and-swarms route as Orchestrate Team of Agents in generated breadcrumbs.

2026-07-13

• Fixed broken /docs/* links in local dev and production by adding a Vite middleware rewrite and a Cloudflare Pages redirect (/docs/* → /*). Pages such as /docs/guides/sub-agent-catalog.html now load correctly.
• Added headless deployment tutorials for VPS, AWS EC2, DigitalOcean, Docker, Cloudflare Tunnel, Workers, and Containers, with navigation and Markdown mirrors.
• Refreshed working-with-autohand-code/cli-reference and working-with-autohand-code/slash-commands against the current Autohand Code CLI.
• Added Sakana AI provider setup and GLM 5.2 model guidance across integrations, model selection, and Agent SDK examples.
• Routed /docs/admin and related administration paths to the primary Autohand admin experience.
• Unified the shared docs shell with normalized routes, expanded navigation groups, and a generated right-side table of contents.
• Standardized code-block presentation, installer tabs, typography, and responsive docs styling.
• Added the changelog, sitemap, robots, SEO/GEO metadata, Markdown export, and LLM discovery publishing pipeline.
• Added repository contribution guidance for changelog discipline and build validation.
• Refreshed db/seed.sql so the docs catalog includes all 224 current pages and navigation sections.
• Removed trailing whitespace from generated changelog Atom entries.
• Updated working-with-autohand-code/slash-commands to reflect the latest Autohand CLI slash command registry: added /fork, /clone, /tree, /statusline, /usage, /go, /handoff session, /review, /pr-review, /deep-research, /deep-search, /autoresearch, /setup, /yolo, /tools, /experiments, /goal, /squad, /skills info, /skills deactivate, and /agents new; corrected /search to web-search provider configuration; removed /commit; updated the generated Markdown mirror.
• Fixed the shared DocsLayout bootstrap for guides/sub-agent-catalog and tutorials/build-specialist-agent-team, restoring navigation and footer rendering.
• Added guides/sub-agent-catalog and tutorials/build-specialist-agent-team with Autohand Code 0.9.3 availability, approval, installation, and delegation guidance.
• Updated working-with-autohand-code/agent-teams, guide and tutorial indexes, and sidebar navigation with catalog and GitHub links.

2026-06-26

• Moved the sidebar New badge from working-with-autohand-code/chrome to the Assembly section.
• Added Cursor Agent to the working-with-autohand-code/assembly supported harness coverage.
• Expanded working-with-autohand-code/assembly with stronger positioning, supported harnesses, custom profile steps, and failed-session restart guidance.
• Added a /code/assembly/ route shortcut for local and deployed Assembly docs access.
• Added a new collapsible Assembly category under Working with Autohand (src/components/DocsLayout.vue).
• Added Assembly getting-started pages covering installation, dashboard, creating sessions, projects and profiles, sessions and audit logs, memory, and events and hooks (src/working-with-autohand-code/assembly/).
• Captured real Assembly UI screenshots and saved them to public/media/assembly/.

2026-06-25

• Expanded hooks, automation, and tool-extension examples with JavaScript, TypeScript, Python, Go, Java, Swift, and curl variants.
• Expanded all Tutorials sidebar groups on /tutorials/ so the full tutorial inventory is visible.
• Restored DocsLayout.vue right-side table of contents and fixed duplicated CodeBlock.vue headers.
• Fixed generated code examples in hooks and automation pages so Vue can compile the docs shell.
• Switched documentation font to Manrope across all pages and components.
• Improved docs discoverability by generating a comprehensive sitemap.xml with image metadata for 196 pages.
• Strengthened structured data for collection/index pages using CollectionPage with hasPart → ItemList.
• Fixed code-block HTML entity rendering for inline <script>-supplied code samples.
• Restructured external provider tutorial references into card lists with title, domain, description, and external-link indicator.
• Added a hooks and events guide under Code (/working-with-autohand-code/hooks-and-events.html).
• Added a hooks and events technical article under Agent SDK Core Concepts (/agent-sdk/concepts/hooks-and-events.html).
• Added an "Extend with Tools" article under Agent SDK Extend with Tools (/agent-sdk/tools/extend-with-tools.html).
• Added a new Agent SDK Automation category with overview, event-driven agents, scheduled tasks, CI/CD integrations, and real-time notifications articles.
• Added a new /guides/automation/ category with overview, hooks and events, and building event-driven agents guides.
• Added a new /tutorials/automations/ category with overview, real-time notifications, CI reviewer bot, and event-driven refactor tutorials.
• Added a new /tutorials/extend-with-tools.html tutorial.
• Updated sidebar navigation, guide index, and tutorial index with the new categories.

2026-06-09

• Initial documentation platform release with guides, tutorials, API reference, and search.