Tutorials

Extensions

Build real Autohand Code extension packages from an empty directory through validation, runtime use, project composition, diagnostics, and immutable distribution.

Start with a complete lifecycle

Start here

Build your first extension with $extension-builder

Ask the built-in authoring skill for a complete package, then inspect its tool, agent, contributed SKILL.md, validation, invocation, and lifecycle proof.

Fast guided first build
Level 500

Integrate with Atlassian Rovo

Combine a declarative Agent Skill with Rovo MCP, OAuth, live tool discovery, mutation confirmation, verification, and production controls.

Advanced enterprise integration
Runtime API

Build a trusted runtime extension

Register /deploy, an Ink menu, line content, a shortcut, flag, hook, provider, and permission policy behind explicit trust.

Executable Extension API v1

Develop with links and live refresh

Use --link safely, diagnose edits, refresh an active session, and prove the copied artifact before release.

Development loop
Composition

Build a project-scoped barebone CLI

Install a controlled extension set under .autohand/extensions and run it with autohand --bare.

Minimal team runtime

Validate and publish

Create failure fixtures, automate JSON checks, verify copied installation, and distribute an immutable source release.

Release workflow

Build the reference patterns

These tutorials reproduce the packages shipped with the Autohand Code CLI. Together they cover tool, agent, skill, and trusted runtime contributions with exact file contents.

Code Health

Combine a TODO/FIXME discovery tool with a maintainability reviewer.

Tool + agent

Test Triage

Use a required file parameter and resolve an extension tool inside an agent allowlist.

Focused execution

Git Insights

Package multiple deterministic, read-only Git evidence tools.

Multiple tools

Security Audit

Compose useful audit commands without treating install-time validation as approval.

Authorization boundary

Release Assistant

Use versioned metadata, a multi-parameter template, and an evidence-driven planner.

Release workflow
Agent Skill

Workspace Brief

Pair deterministic Git evidence tools with a portable $workspace-brief workflow.

Tools + skill

Prerequisites for every tutorial

  • A current Autohand Code CLI with the autohand extensions command tree.
  • A safe test repository; do not evaluate a new package in a sensitive production checkout.
  • An editor that preserves UTF-8 and JSON formatting.
  • The executables referenced by the tutorial handlers, such as git or bun.
  • A normal permission policy so you can verify approval and denial behavior.
autohand extensions --help
autohand --version