mirror of https://github.com/wu736139669/hapi.git synced 2026-08-05 06:24:37 +00:00

Files

T

Mao MrandGitHub c9be2894ac feat(cursor): add support for Cursor Agent CLI integration (#236 )

* feat(cursor): add support for Cursor Agent CLI integration

- Introduced new command `hapi cursor` to start Cursor Agent sessions.
- Added functionality for resuming sessions and managing permission modes.
- Updated documentation to include Cursor Agent usage and installation instructions.
- Enhanced existing codebase to accommodate Cursor as a recognized agent flavor.
- Implemented local and remote session handling for Cursor Agent.

This update expands HAPI's capabilities by integrating support for the Cursor Agent, allowing users to leverage its features alongside existing agents.

* Remove TODO.md file as it is no longer needed following the integration of Cursor Agent CLI support. This cleanup helps streamline project documentation and reflects the completion of the associated tasks.

* feat(cursor): implement remote mode and fix --hapi-starting-mode

- Consume --hapi-starting-mode in cursor command (do not forward to agent)
- Implement cursorRemoteLauncher: spawn agent -p with stream-json, --trust
- Add cursorEventConverter for NDJSON parsing (system/assistant/tool_call/result)
- Multi-turn via --resume session_id
- Update docs: cursor supports both local and remote modes

Made-with: Cursor

* fix: type error

* fix(cursor): address PR review - model UI, sessionId metadata, duplicate flags

- HappyComposer: use isClaudeFlavor for model mode (cursor has no model modes)
- cursorLocalLauncher: call onSessionFound for resume so cursorSessionId in metadata
- cursorCommand: do not forward parsed flags to cursorArgs (avoid duplicates)

Made-with: Cursor

2026-03-03 10:02:47 +08:00

2.0 KiB

Raw Blame History

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)

Cursor CLI Documentation
How it Works - Architecture and data flow

2.0 KiB Raw Blame History