Skip to main content

​
Overview

HAPI wraps the Claude Code CLI to provide remote control capabilities through web and Telegram. Start sessions from your terminal and monitor/control them from anywhere.

​
Requirements

  • Claude Code CLI installed and logged in (claude on PATH)
  • HAPI CLI installed (hapi command available)
  • Authenticated with HAPI hub (hapi auth login)

​
Starting a Session

​
Basic Usage

hapi                    # Start Claude Code session
hapi --resume           # Resume the most recent session

​
With Options

hapi --yolo             # Bypass permissions (sugar for --dangerously-skip-permissions)
hapi --model opus       # Use a specific model
hapi --hapi-starting-mode remote  # Start in remote mode
HAPI supports ALL Claude Code CLI flags! Use any claude flag with hapi as you would normally.

​
Available Flags

​
HAPI-Specific Flags

FlagDescription
--hapi-starting-modeSet initial mode: local or remote
--yoloBypass permissions (alias for --dangerously-skip-permissions)
--started-byInternal flag for runner management

​
Claude Code Flags

All standard Claude Code flags are supported:
  • --resume - Resume the most recent session
  • --model <model> - Specify model (sonnet, opus, etc.)
  • --dangerously-skip-permissions - Bypass all permission prompts
  • And all other claude flags
Run hapi --help to see the full list.

​
Permission Modes

Claude Code supports these permission modes:

Default

Standard Claude behavior with permission prompts

Accept Edits

Automatically accept edit operations

Plan Mode

Design approach before implementing changes

Yolo

Bypass all permissions (use with caution)
Change permission modes from the web UI during an active session. See shared/src/modes.ts:1 for mode definitions.

​
Session Modes

​
Local Mode

Start from terminal with full interactive experience: 
hapi
In local mode:
  • Full terminal interaction with Claude
  • Messages from web/phone are queued
  • Switch to remote mode anytime from the UI

​
Remote Mode

Control entirely from web/phone: 
hapi --hapi-starting-mode remote
In remote mode:
  • Session waits for messages from hub UI/Telegram
  • No terminal interaction
  • Switch to local mode anytime from the UI

​
Resume Functionality

Claude Code has built-in session resume: 
# Resume most recent session
hapi --resume

# Any other Claude resume flags work too
Sessions automatically register with HAPI hub, allowing you to:
  • View session history in web UI
  • Continue conversations from any device
  • Track all interactions

​
Examples

​
Start Standard Session

hapi

​
Resume Previous Session

hapi --resume

​
Start with Auto-Accept Edits

hapi --yolo

​
Start with Specific Model

hapi --model opus

​
Start in Remote Mode

hapi --hapi-starting-mode remote
Then control entirely from the web app or Telegram.

​
Integration

Once running, your Claude Code session appears in:
  • HAPI web app
  • Telegram Mini App
You can:
  • Monitor session activity in real-time
  • Approve permissions from your phone
  • Send messages (queued in local mode)
  • Switch between local and remote modes
  • Change permission modes on the fly
hapi auth status        # Check authentication
hapi runner status      # View background service status
hapi doctor             # Run diagnostics

​
Source Reference

  • Command implementation: cli/src/commands/claude.ts
  • Session runner: cli/src/claude/runClaude.ts
  • Permission modes: shared/src/modes.ts:1-4

Build docs developers (and LLMs) love

Get started for freeTalk to us