---
title: "Extensions Tutorials"
source: https://docs.autohand.ai/tutorials/extensions/
---

# 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](/tutorials/extensions/authoring-your-first-extension.html)[

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](/tutorials/extensions/500-atlassian-rovo-integration.html)[

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](/tutorials/extensions/build-runtime-extension.html)[

### Develop with links and live refresh

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

Development loop](/tutorials/extensions/linked-development-workflow.html)[

Composition

### Build a project-scoped barebone CLI

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

Minimal team runtime](/tutorials/extensions/project-scoped-barebone.html)[

### Validate and publish

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

Release workflow](/tutorials/extensions/validate-and-publish.html)

## 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](/tutorials/extensions/code-health-extension.html)[

### Test Triage

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

Focused execution](/tutorials/extensions/test-triage-extension.html)[

### Git Insights

Package multiple deterministic, read-only Git evidence tools.

Multiple tools](/tutorials/extensions/git-insights-extension.html)[

### Security Audit

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

Authorization boundary](/tutorials/extensions/security-audit-extension.html)[

### Release Assistant

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

Release workflow](/tutorials/extensions/release-assistant-extension.html)[

Agent Skill

### Workspace Brief

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

Tools + skill](/tutorials/extensions/workspace-brief-extension.html)

## 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.

``` bash
autohand extensions --help
autohand --version
```