Skip to content

Latest commit

 

History

History

hapi-tutorial

README.md

layout title nav_order has_children format_version
default
HAPI Tutorial
100
true
v2

HAPI Tutorial: Remote Control for Local AI Coding Sessions

Learn tiann/hapi, a local-first hub that lets you run Claude Code/Codex/Gemini/OpenCode sessions locally while controlling and approving them remotely.

Stars License Docs

Why This Track Matters

HAPI solves the remote oversight problem for local AI coding sessions — you can run Claude Code or other agents on your laptop while monitoring, approving, and controlling them from a phone or browser anywhere.

This track focuses on:

  • setting up local-first AI coding sessions with remote control capability
  • designing safe approval policies for agent tool access
  • operating HAPI across multiple machines and networks
  • hardening and monitoring HAPI for team usage

What is HAPI?

HAPI wraps existing coding agents and adds a hub/web control plane so sessions can be handed off between terminal and phone/browser without restarting context.

Current Snapshot (auto-updated)

  • repository: tiann/hapi
  • stars: about 2.4k
  • latest release: v0.16.1 (published 2026-03-08)

Chapter Guide

  1. Chapter 1: Getting Started - install HAPI, start hub, and launch first wrapped agent session
  2. Chapter 2: System Architecture - CLI, hub, web app, and protocol boundaries
  3. Chapter 3: Session Lifecycle and Handoff - local-to-remote control flow and state continuity
  4. Chapter 4: Remote Access and Networking - relay mode, tunnels, and secure exposure patterns
  5. Chapter 5: Permissions and Approval Workflow - mobile approvals, policy boundaries, and safety controls
  6. Chapter 6: PWA, Telegram, and Extensions - user interfaces, notifications, and ecosystem integration
  7. Chapter 7: Configuration and Security - tokens, env vars, secrets handling, and access governance
  8. Chapter 8: Production Operations - observability, scaling, and incident runbooks

What You Will Learn

  • run a local-first AI coding stack with remote control
  • design safe approval policies for agent tool access
  • operate HAPI across multiple machines and networks
  • harden and monitor HAPI for team usage

Source References

Related Tutorials

Ready to begin? Continue to Chapter 1: Getting Started.

Navigation & Backlinks

Full Chapter Map

  1. Chapter 1: Getting Started
  2. Chapter 2: System Architecture
  3. Chapter 3: Session Lifecycle and Handoff
  4. Chapter 4: Remote Access and Networking
  5. Chapter 5: Permissions and Approval Workflow
  6. Chapter 6: PWA, Telegram, and Extensions
  7. Chapter 7: Configuration and Security
  8. Chapter 8: Production Operations

Mental Model

flowchart TD
    A[Foundations] --> B[Core Abstractions]
    B --> C[Interaction Patterns]
    C --> D[Advanced Operations]
    D --> E[Production Usage]
Loading

Generated by AI Codebase Knowledge Builder