Skip to content

cursor.md

Latest commit

 

History

History
62 lines (42 loc) · 2.04 KB

cursor.md

File metadata and controls

62 lines (42 loc) · 2.04 KB

Cursor Agent

HAPI supports Cursor Agent CLI for running Cursor's AI coding agent with remote control via web and phone.

Prerequisites

Install Cursor Agent CLI:

  • macOS/Linux: curl https://cursor.com/install -fsS | bash
  • Windows: irm 'https://cursor.com/install?win32=true' | iex

Verify installation:

agent --version

Usage

hapi cursor                    # Start Cursor Agent session
hapi cursor resume <chatId>    # Resume a specific chat
hapi cursor --continue         # Resume the most recent chat
hapi cursor --mode plan        # Start in Plan mode
hapi cursor --mode ask         # Start in Ask mode
hapi cursor --yolo             # Bypass approval prompts (--force)
hapi cursor --model <model>    # Specify model

Permission Modes

Mode Description
default Standard agent behavior
plan Plan mode - design approach before coding
ask Ask mode - explore code without edits
yolo Bypass approval prompts

Set mode via --mode flag or change from the web UI during a session.

Modes

  • Local mode - Run hapi cursor from terminal. Full interactive experience.
  • Remote mode - Spawn from web/phone when no terminal. Uses agent -p with --output-format stream-json and --trust. Each user message spawns one agent process; session continues via --resume.

Limitations

  • Tool approval - In remote mode, --trust is used; tools run without per-request approval. Use --yolo for full bypass.
  • Session resume - Pass --resume <chatId> or --continue to resume. Use agent ls to list previous chats and get chat IDs.

Integration

Once running, your Cursor session appears in the HAPI web app and Telegram Mini App. You can:

  • Monitor session activity
  • Approve permissions from your phone
  • Send messages when in local mode (messages queue for when you switch)

Related