Agent skill

Reset Cursor Acp

by davidondrej in davidondrej/skills

Reset a stuck Cursor ACP thread in <chat-system and reload its configuration.

MITAuto-check passedAgent Workflows

Install Reset Cursor Acp

skills CLI
$ npx skills add davidondrej/skills --skill reset-cursor-acp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davidondrej/skills reset-cursor-acp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davidondrej/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agent-orchestration/reset-cursor-acp .claude/skills/reset-cursor-acp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
reset-cursor-acp
GitHub stars
4.1k
Token cost
~728 tokens
SKILL.md length
318 words
Files
3 (incl. scripts)
Skills in repo
51
Repo updated
First seen
Licence
MIT

At a glance

Reset a stuck Cursor ACP thread in <chat-system and reload its configuration.

  • Explicitly invokes /reset-cursor-acp
  • SKILL.md covers How resets work, Quick reset, Verify and Known causes, plus 1 more section
  • Runs Shell scripts from its folder

What it does

Reset Cursor Acp is an agent skill from davidondrej/skills. Reset a stuck Cursor ACP thread in <chat-system and reload its configuration. Use only when the user explicitly invokes /reset-cursor-acp.

Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `agents/openai.yaml` and `scripts/reset-cursor-acp.sh`).

It sits in Agent Workflows. It works with Model Context Protocol. The repository describes itself as: access to david ondrej's personal agent skills. The licence is MIT.

When your agent uses it

  • Explicitly invokes /reset-cursor-acp

Example prompts

  • “/reset-cursor-acp”

Requirements

  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit 7874889. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reset Cursor Acp loads about 728 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 318 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~728

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from davidondrej/skills at commit 7874889, republished under its MIT licence (© davidondrej). 318 words, ~728 tokens.

Download SKILL.mdSave it as .claude/skills/reset-cursor-acp/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
reset-cursor-acp
description
Reset a stuck Cursor ACP thread in <chat-system> and reload its configuration. Use only when the user explicitly invokes /reset-cursor-acp.
disable-model-invocation
true

Reset Cursor ACP in <chat-system>

For terminal sessions use cursor-cli; for general <chat-system> control use <chat-cli>.

How resets work

  • The <ACP-plugin> starts one cursor-agent acp subprocess per thread, on demand, owned by a <bridge-worker>.
  • There is no global Cursor ACP server. Do not create one or keep it alive with a watchdog.
  • Rules, skills, and .cursor/mcp.json reload when a new subprocess starts.
  • <chat-cli> thread stop <id> releases the runtime and stops its subprocess, preserving history. The next message starts a fresh agent.

Quick reset

Resolve <reset-script> relative to this SKILL.md. Run:

bash
<reset-script> <thread-id>      # reset one Cursor thread
<reset-script> --self           # reset the current thread (<CURRENT_THREAD_ID>)
<reset-script>                  # no thread: orphan cleanup + health check only
<reset-script> --dry-run        # show what would happen
<reset-script> <id> --kill-all  # also kill live agents of OTHER Cursor threads

Find Cursor thread ids with <chat-cli> status (current thread) or:

bash
<thread-list-command>

The script stops the selected thread, removes orphaned cursor-agent acp processes (parent gone or not a <bridge-worker>), reports CLI version/login/update status, and asks for the next message. Other threads stay running unless --kill-all.

If sandboxing blocks ps with "operation not permitted", rerun the script outside the sandbox.

Verify

Send one short message to verify a fresh agent responds. If it hangs again, check the causes below before another reset.

Known causes

  • Old Cursor CLI. If the health check shows an update, run <update-command>, then reset.
  • Expired login. Symptom "Failed to initialize session services". Fix: cursor-agent login, then reset.
  • Pending permission. Cursor waits for session/request_permission. Check and resolve the thread's pending approval before resetting.
  • Resume failure. For session/load → "Session not found", use a fresh session after <chat-cli> thread stop rather than retrying the load.
  • Team-level MCP servers from the Cursor dashboard do not work in ACP mode. Only project or user .cursor/mcp.json.
  • Rate limits. Enable retries with <chat-cli> plugin enable <retry-plugin>.

Do not

  • No launchd KeepAlive, cron, or watchdog for cursor-agent acp.
  • Never blindly run pkill -f cursor-agent; it kills all Cursor threads and the interactive TUI. Use the script, which targets orphans by default.
  • Do not restart <chat-system> for one stuck thread; use <chat-cli> thread stop.
  • Do not use <chat-cli> thread compact; Cursor does not support it.

© davidondrej, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in skills/agent-orchestration/reset-cursor-acp of davidondrej/skills.

  • SKILL.md
  • agents/openai.yaml
  • scripts/reset-cursor-acp.sh

Open the folder on GitHubat commit 7874889

Compare with similar skills

Reset Cursor Acp next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reset Cursor Acp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reset Cursor Acp this skilldavidondrej/skills4.1k—~728Automated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
MemPalace Memory SearchMemPalace/mempalace59k—~1.4kAutomated safety check: PassMIT
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • MemPalace Memory Search

    MemPalace/mempalace

    Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.

    59k GitHub stars~1.4k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from davidondrej/skills

All 51 skills in this repo
  • Nagent

    davidondrej/skills

    Launch a new bb worker thread with the right project, model, worktree, and task brief.

    4.1k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check: notes
  • Browser Harness

    davidondrej/skills

    Direct browser control via CDP. An agent skill from davidondrej/skills.

    4.1k GitHub starsUsed in 2 repos~3k tokens
    Auto-check passed
  • Persistent Localhost

    davidondrej/skills

    Manage persistent dev servers, APIs, and other local processes on a port using macOS LaunchAgents.

    4.1k GitHub stars~618 tokensUpdated yesterday
    Auto-check passed
  • Anti Sleep

    davidondrej/skills

    Keep a Mac awake for a set duration or while a process runs.

    4.1k GitHub stars~640 tokensUpdated yesterday
    Auto-check: warnings
  • Bb CLI

    davidondrej/skills

    Use this when controlling bb. An agent skill from davidondrej/skills.

    4.1k GitHub stars~823 tokensUpdated yesterday
    Auto-check passed
  • Boat

    davidondrej/skills

    Manage Boat (boat.dev, formerly Box by Ascii) cloud sandboxes via API, CLI, and SSH.

    4.1k GitHub stars~2k tokensUpdated yesterday
    Auto-check: notes

Categories

Questions about Reset Cursor Acp

What does Reset Cursor Acp do?

Reset a stuck Cursor ACP thread in <chat-system and reload its configuration. Reset Cursor Acp is an agent skill from davidondrej/skills. Reset a stuck Cursor ACP thread in <chat-system and reload its configuration.

When should I use Reset Cursor Acp?

Reset Cursor Acp fits situations like: explicitly invokes /reset-cursor-acp.

How do I install Reset Cursor Acp in Claude Code?

Run `npx skills add davidondrej/skills --skill reset-cursor-acp -a claude-code`. Or copy the skill folder (skills/agent-orchestration/reset-cursor-acp in davidondrej/skills) into .claude/skills/reset-cursor-acp in your project. Claude Code loads it when a task matches its description.

How do I install Reset Cursor Acp in Codex?

Run `npx skills add davidondrej/skills --skill reset-cursor-acp -a codex`. Or copy the skill folder (skills/agent-orchestration/reset-cursor-acp in davidondrej/skills) into .agents/skills/reset-cursor-acp in your project. Codex loads it when a task matches its description.

Can I use Reset Cursor Acp in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davidondrej/skills --skill reset-cursor-acp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reset-cursor-acp, .gemini/skills/reset-cursor-acp, .github/skills/reset-cursor-acp and .opencode/skills/reset-cursor-acp in your project.

What does Reset Cursor Acp need to run?

Going by SKILL.md and its folder, Reset Cursor Acp needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Reset Cursor Acp access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Reset Cursor Acp safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Reset Cursor Acp use?

Reset Cursor Acp is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reset Cursor Acp use?

About 728 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reset Cursor Acp?

Skills that share tags, products or a category with Reset Cursor Acp: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and MemPalace Memory Search (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reset Cursor Acp?

davidondrej (a GitHub user) maintains it in davidondrej/skills, which has 4,112 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 8, 2026.

Source: davidondrej/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.