---
title: "Guides"
source: https://docs.autohand.ai/guides/
---

# Guides

Step-by-step tutorials to help you get the most out of Autohand. From automated testing to enterprise migrations, these guides walk you through real-world workflows.

## Getting started

New to Autohand Code? Start with these comprehensive guides to get up and running quickly.

[

Popular

### Getting Started with Autohand Code

Complete guide to installing and using Autohand Code. Learn setup, first project, and essential workflows.

20 min read](/docs/guides/getting-started.html)[

New

### CLI Quick Start

Master the Autohand Code command-line interface in minutes. Essential commands and productivity workflows.

15 min read](/docs/guides/cli-quick-start.html)[

New

### VS Code Setup

Complete guide to installing and configuring Autohand Code in Visual Studio Code for optimal productivity.

18 min read](/docs/guides/vs-code-setup.html)[

Tutorial

### First Project Tutorial

Build your first complete full-stack web application with AI assistance. Step-by-step tutorial with React, Node.js, and more.

45 min read](/docs/guides/first-project.html)[

### Your First Session

Interactive guided tutorial with hands-on exercises to learn Autohand Code fundamentals.

15 min read](/docs/getting-started/first-session.html)

## Editor integrations

Use Autohand directly in your favorite code editor for seamless AI-assisted development.

[

New

### VS Code Features

Learn about all available features in the Autohand VS Code extension including inline suggestions and chat panel.

10 min read](/docs/working-with-autohand-code/code/vscode/features.html)[

Popular

### Zed Editor Integration

Use Autohand CLI as an AI agent in Zed editor through the Agent Client Protocol (ACP) adapter.

12 min read](/docs/guides/zed-integration.html)

## Automation and CI/CD

Integrate Autohand into your development pipeline for automated code reviews, testing, and deployments.

[

New

### CI/CD Automation

Automate code reviews, test analysis, and release notes in GitHub Actions, GitLab CI, and Jenkins.

18 min read](/docs/guides/ci-cd-automation.html)[

New

### Git Flow Automation

Execute 100+ tasks in parallel using Git worktrees. Automatic branch management with safe merging to main.

15 min read](/docs/guides/git-flow-automation.html)[

New

### Automation with Hooks and Events

Configure shell hooks, respond to agent lifecycle events, and build event-driven automation workflows.

12 min read](/docs/guides/automation/index.html)[

### Headless Mode

Run Autohand in CI/CD pipelines without user interaction. Perfect for automated testing and deployment scripts.

8 min read](/docs/working-with-autohand-code/headless-mode.html)[

### Enterprise Security

Configure Autohand for enterprise environments with SSO, audit logging, and compliance controls.

15 min read](/docs/guides/enterprise-security.html)

## Autonomous SRE

Build AI-powered site reliability with automated incident response, observability integration, and self-healing infrastructure.

[

New

### Incident Response

Configure automated incident detection, classification, and response with AI-powered root cause analysis.

15 min read](/docs/guides/sre/incident-response.html)[

### Agent Architecture

Understand the AI SRE agent components: reasoning engines, action chains, memory systems, and feedback loops.

20 min read](/docs/guides/sre/agent-architecture.html)[

### Observability Integration

Connect OpenTelemetry, eBPF, and your monitoring stack for deep signal extraction and analysis.

18 min read](/docs/guides/sre/observability.html)[

### Runbook Automation

Create automated remediation workflows with triggers, safeguards, and Terraform integration.

22 min read](/docs/guides/sre/runbook-automation.html)

## Migration and modernization

Transform legacy systems and reduce technical debt with AI-assisted migrations. Comprehensive guides for modernizing every major language and platform.

[

Popular

### Code Modernization

Comprehensive guide to modernizing legacy codebases. Best practices for large-scale transformations with automated refactoring and testing.

20 min read](/docs/guides/code-modernization.html)[

Enterprise

### COBOL Modernization

Transform COBOL mainframe applications into modern cloud-native services while preserving decades of business logic.

30 min read](/docs/guides/cobol-modernization.html)[

### Java Modernization

Upgrade from Java 8 to 17+ and modernize Spring Boot applications with automated testing and validation.

25 min read](/docs/guides/java-modernization.html)[

### .NET Modernization

Migrate from .NET Framework to .NET 8+ and modernize ASP.NET applications with cloud-native patterns.

28 min read](/docs/guides/dotnet-modernization.html)[

### PHP Modernization

Upgrade from PHP 5/7 to PHP 8+ and transform legacy PHP applications with modern frameworks and patterns.

22 min read](/docs/guides/php-modernization.html)[

### Python Modernization

Migrate from Python 2 to Python 3+ and modernize Django/Flask applications with async patterns and type hints.

24 min read](/docs/guides/python-modernization.html)[

### Ruby/Rails Modernization

Upgrade from Ruby 2.x to Ruby 3+ and modernize Rails applications with async programming and modern patterns.

26 min read](/docs/guides/ruby-modernization.html)[

### Node.js/JavaScript Modernization

Transform legacy JavaScript to ES2022+ and modernize Node.js applications with async/await and TypeScript.

23 min read](/docs/guides/nodejs-modernization.html)[

### Database Modernization

Migrate from Oracle/SQL Server to PostgreSQL and modernize data architecture with zero downtime migrations.

32 min read](/docs/guides/database-modernization.html)[

### Legacy Migration

Migrate legacy applications to modern frameworks with automated code transformation and comprehensive testing.

25 min read](/docs/guides/legacy-migration.html)[

### Technical Debt Reduction

Systematically identify and address technical debt with AI-powered analysis and prioritized remediation plans.

15 min read](/docs/guides/technical-debt.html)

## MCP integrations

Extend Autohand with external tools through the Model Context Protocol. These guides show you how to set up and use popular MCP servers for documentation, search, design, and more. See the [MCP overview](/docs/guides/mcp/index.html) for setup basics and curated server lists.

[

New

### How to search the web

Use Brave Search to look up errors, find packages, and research solutions without leaving the terminal.

8 min read](/docs/guides/mcp/brave-search.html)[

New

### How to get accurate documentation

Use Context7 to pull current, version-specific docs so the agent codes against real APIs instead of stale training data.

8 min read](/docs/guides/mcp/context7-docs.html)[

New

### How to extract web content

Use Firecrawl to convert any web page into clean markdown. Read full articles, API references, and tutorials in your session.

8 min read](/docs/guides/mcp/firecrawl-scraping.html)[

New

### How to turn designs into code

Use Figma MCP to read design files and generate pixel-accurate components with correct spacing, colors, and typography.

10 min read](/docs/guides/mcp/figma-design-to-code.html)[

New

### How to run code in a sandbox

Use E2B to execute code in isolated cloud environments. Test scripts, try packages, and process data safely.

10 min read](/docs/guides/mcp/e2b-sandbox.html)

## Orchestrate Team of Agents

Delegate bounded work to specialist sub-agents, coordinate dependency-aware teams, produce cited research, and run measurable autonomous experiment loops.

[

New

### Orchestrate Team of Agents

Choose between one sub-agent, a parallel swarm, a persistent team, deep research, and autoresearch.

18 min read](/docs/guides/teams-and-swarms/index.html)[

### Sub-agents and Delegation

Understand built-ins, catalog roles, definition formats, discovery order, permissions, and parallel limits.

22 min read](/docs/guides/teams-and-swarms/sub-agents.html)[

New

### Sub-agent Catalog

Find, review, and install specialist definitions for immediate delegation and team creation.

10 min read](/docs/guides/sub-agent-catalog.html)[

### Agent Teams and Tasks

Coordinate persistent teammates through shared tasks, dependencies, ownership, messages, and validation.

20 min read](/docs/guides/teams-and-swarms/agent-teams.html)[

### Deep Research

Partition evidence tracks, cross-check primary sources, and save a reusable cited project report.

18 min read](/docs/guides/teams-and-swarms/deep-research.html)[

### Autoresearch

Configure metrics, correctness checks, experiment artifacts, hooks, and delegated analysis phases.

24 min read](/docs/guides/teams-and-swarms/autoresearch.html)[

Playbooks

### Agent Orchestration Playbooks

Named engineering, operations, research, and optimization workflows with prompts, artifacts, and verification gates.

45 min read](/docs/guides/teams-and-swarms/use-cases.html)

## Agent Skills

Pre-built Skills that transform Autohand into specialized AI agents. Each skill includes a complete definition, configuration options, and usage examples.

[

### Autonomous SRE

Monitor infrastructure, detect incidents, and execute automated remediation runbooks.

12 min read](/docs/guides/skills/autonomous-sre.html)[

### Frontend UI

Create polished UI components, implement designs from mockups, and maintain design system consistency.

10 min read](/docs/guides/skills/frontend-ui.html)[

### Service Integration

Connect APIs, handle OAuth flows, and build robust integrations between services.

10 min read](/docs/guides/skills/service-integration.html)[

### Data Querying

Write SQL queries, explore schemas, and extract insights from your databases.

10 min read](/docs/guides/skills/data-querying.html)[

### Internal Tools

Build admin dashboards, CRUD interfaces, and back-office applications quickly.

8 min read](/docs/guides/skills/internal-tools.html)[

### Vibe Coding

Rapid prototyping and creative coding. Turn rough ideas into working code fast.

6 min read](/docs/guides/skills/vibe-coding.html)[

### AI Data Analyst

Analyze datasets, create visualizations, and generate actionable business insights.

10 min read](/docs/guides/skills/ai-data-analyst.html)[

### Product Management

Write PRDs, analyze user feedback, prioritize features, and plan roadmaps.

8 min read](/docs/guides/skills/product-management.html)[

### Browser Automation

Automate browser tasks, scrape websites, fill forms, and run E2E tests with Playwright.

10 min read](/docs/guides/skills/browser-automation.html)

## Quick examples

Copy-paste commands to get started quickly with common tasks.

### Run tests in CI

``` bash
# Run Autohand non-interactively with auto-skill detection
autohand -y --auto-skill --prompt "Run all E2E tests and report failures"

# Pipe test results to Autohand for analysis
npm test 2>&1 | autohand -y --prompt "Analyze these test results and suggest fixes"
```

### Automated code review

``` bash
# Review staged changes before commit
git diff --staged | autohand -y --prompt "Review this diff for bugs and security issues"

# Review a PR
gh pr diff 123 | autohand -y --prompt "Provide a detailed code review"
```

### Generate documentation

``` bash
# Document a new module
autohand --prompt "Generate documentation for src/auth/ following our existing doc style"

# Update API docs after changes
autohand -y --prompt "Update API documentation to reflect recent endpoint changes"
```

## Next steps

[Agent Skills](/docs/working-with-autohand-code/agent-skills.html) - Create custom Skills for your workflows

[Headless Mode](/docs/working-with-autohand-code/headless-mode.html) - Run Autohand in CI/CD pipelines

[GitHub Integration](/docs/integrations/github.html) - Connect to your repositories