菜单
Starts a new interactive local Cursor Agent CLI session (agent command) in the project directory. Use when the user wants a new local Cursor session, Cursor CLI agent, terminal agent, or to run agent on this machine (not cloud).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Recursive epic automation — one agent session per slice, chained via ralph-chain-next.sh. BOOTSTRAP: config + chain + STOP — NEVER product code. WORKER: one child issue per session, then chain. "Implement epic with Ralph" means bootstrap and chain, not ship the epic in the bootstrap chat. One slice per worker session only; do not batch child issues in one session.
Starts a new Cursor Cloud Agent session via the Cloud Agents API and returns the session URL. Use when the user wants a Cursor cloud session, cloud agent, remote Cursor worker, AFK Cursor run, or mentions CURSOR_API_KEY and a new cloud VM.
Starts a new interactive local Claude Code CLI session in the project directory. Use when the user wants a new Claude Code session, claude CLI, terminal Claude, or local Claude agent (not cloud).
Starts a new interactive local OpenAI Codex CLI session (codex TUI) in the project directory. Use when the user wants a new Codex session, codex CLI, terminal Codex, or local Codex agent (not cloud).
Starts a new Oz (Warp) cloud agent run via the Oz API and returns the session link. Use when the user wants an Oz cloud session, Warp cloud agent, remote-oz worker, or mentions WARP_API_KEY and OZ_ENVIRONMENT_ID.
Run the full Playwright E2E suite and publish the HTML report with all test screenshots to GitHub Pages. Use when the user asks to run E2E tests and publish/share/view screenshots on mobile, update GitHub Pages with E2E results, or run the E2E suite from Cursor Cloud.
| name | start-local-cursor-session |
| description | Starts a new interactive local Cursor Agent CLI session (agent command) in the project directory. Use when the user wants a new local Cursor session, Cursor CLI agent, terminal agent, or to run agent on this machine (not cloud). |
Open a new interactive Cursor Agent CLI session on the user's machine. Default command: agent (also packaged as cursor-agent on some installs).
Distinct from:
start-cursor-cloud-session or & in the CLI to hand off to cloudagent -p --force -- "prompt" (non-interactive; Ralph local-cursor worker)| Requirement | Notes |
|---|---|
agent on PATH | Install Cursor Agent CLI; verify with agent about or agent status |
| Auth | agent login if agent status shows logged out |
| Project directory | Run from repo root (cd "$(git rev-parse --show-toplevel)") |
cd "$(git rev-parse --show-toplevel)"
agent
With an initial prompt:
agent "Explain this repo and list the main apps"
start-cursor-cloud-session..cursor/ apply.agent for empty chat, or quoted prompt for first message.agent --worktree uses a new git worktree under ~/.cursor/worktrees instead of dirtying the main checkout.tmux (see below).| Goal | Command |
|---|---|
| Brand-new chat | agent or agent create-chat (prints id for scripting) |
| Continue latest | agent resume or agent --continue |
| Resume by id | agent --resume <thread-id> |
| Plan-first | agent --plan or agent --mode plan |
| Isolated checkout | agent --worktree |
| List past chats | agent ls |
When the user wants a new session that keeps running after you disconnect:
SESSION_NAME="cursor-$(basename "$(git rev-parse --show-toplevel)")"
tmux new-session -d -s "$SESSION_NAME" -c "$(git rev-parse --show-toplevel)" -- agent
echo "Attach: tmux attach -t $SESSION_NAME"
Adjust tmux config if the environment provides one (e.g. cloud VMs may use /exec-daemon/tmux.portal.conf).
Ralph and CI use print mode — not a new interactive session:
agent -p --force -- "Implement issue #42"
start-cursor-cloud-sessionralph.config.json with "worker": "local-cursor" + .ralph/scripts/ralph-chain-next.sh (see .ralph/README.md)