Cursor

ACT on Cursor ships as a local plugin that exposes ACT commands, agents, and skills.

Install

cd ~/.agentic-coding-toolkit && ./scripts/install.sh --tool cursor

What Gets Installed

Location	Includes
`~/.cursor/plugins/local/`	Symlinked ACT local plugin directory
`~/.config/agentic-coding-toolkit/`	Shared ACT settings and copied runtime helper

Verify

After installing or updating ACT for Cursor:

Restart or reload Cursor
Open Agent chat
Type /act-

You should see ACT’s available act-* skills.

Skills

Invoke ACT skills from Agent chat using the same canonical names documented across the site, for example:

/act-workflow-plan ai_specs/settings-spec.md
/act-git-commit

Commands and Agents

ACT commands such as /act-help and /act-update are supported
ACT agents are supported
/act-help works as the main command navigator

Hooks

ACT hooks are not currently supported on Cursor.

Permissions

Cursor supports a global per-user ~/.cursor/permissions.json file for persistent terminal and MCP allowlists.

For ACT, the useful minimum is:

{
  "terminalAllowlist": [
    "git",
    "flutter",
    "dart",
    "node",
    "gh"
  ]
}

To make this effective:

enable Auto-Run in Sandbox or Run Everything in Cursor Settings
do not use Ask Every Time, since Cursor ignores allowlists in that mode
use the same isolation mindset as other high-autonomy setups: prefer a non-sensitive account or containerized environment when appropriate

This reduces repeated terminal approval prompts for ACT skills. Cursor’s built-in read/write/search tools are still governed by Cursor’s auto-run mode rather than permissions.json, and there is no per-project override.

Relevant Cursor docs:

Update

After updating ACT, rerun the installer to verify or recreate the Cursor local plugin symlink, then restart or reload Cursor:

cd ~/.agentic-coding-toolkit && ./scripts/install.sh --tool cursor

Uninstall

cd ~/.agentic-coding-toolkit && ./scripts/uninstall.sh --tool cursor

After running ./scripts/uninstall.sh --tool cursor, /act-* skills may remain visible until you fully close and restart Cursor.

Uninstall removes only the ACT-owned Cursor plugin symlink. It leaves shared ACT settings under ~/.config/agentic-coding-toolkit untouched.

Best Fit

You want ACT inside an editor-native agent workflow
You prefer to use ACT commands, agents, and skills directly
You do not need ACT hook parity