Installation

Prerequisites

Before installing ACT, make sure you have:

• One supported AI client — Claude Code, OpenCode, Codex CLI, or Cursor
• Git — for version control and worktree support
• Flutter SDK — for Flutter/Dart projects (install guide)
• Node.js — required for ACT runtime helpers and hook integrations

Returning ACT user?

If you last used ACT before the skill migrations, see Commands to Skills Migration. Workflow and git entrypoints are now documented as direct act-* skills, and Flutter knowledge loading now goes through /act-flutter-development.

Note for Windows users

For the best experience on Windows, use WSL and run the entire setup inside your WSL terminal. This matches the OpenCode Windows recommendation.

• Clone ACT from WSL
• Run the installer from WSL
• Launch your AI client from that same WSL environment

Avoid mixing native Windows shells (PowerShell, CMD, Git Bash) with a WSL install, since ACT integrations may not be detected correctly across environments.

Install

1. Clone the toolkit

git clone https://github.com/CodeWithAndreaPro/agentic-coding-toolkit ~/.agentic-coding-toolkit

This clones ACT to ~/.agentic-coding-toolkit in your home directory.

On Windows with WSL, ~ refers to your WSL home directory, which is the recommended setup.

2. Run the installer

For Claude Code

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

Use a separate Claude Code config directory

Use either supported custom directory option:

# Separate Claude Code config
cd ~/.agentic-coding-toolkit && ./scripts/install.sh --tool claude --config-dir ~/.claude-work

# Claude Code's CLAUDE_CONFIG_DIR environment variable
CLAUDE_CONFIG_DIR=~/.claude-work ./scripts/install.sh --tool claude

Claude config precedence is --config-dir first, then CLAUDE_CONFIG_DIR, then ~/.claude.

See Claude Code’s Environment Variables docs for more info about CLAUDE_CONFIG_DIR.

For OpenCode

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

For Codex

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

For Cursor

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

If you use multiple clients, run each install command you need.

Note

The install script sets up ACT globally — no per-project installation needed. It:

• Creates Claude Code/OpenCode integrations for ACT commands, agents, and skills
• Creates generated Codex integrations for ACT skills, agents, and supported hooks
• Installs ACT’s local Cursor plugin for commands, agents, and skills
• Installs hooks for supported clients
• Bootstraps shared ACT runtime settings and helpers
• Points everything back to ~/.agentic-coding-toolkit

3. Verify

Start a new session from the same environment where you installed ACT, then use the check that matches your client:

• Claude Code/OpenCode/Cursor: run /act-help
• OpenCode: you can also open /skills and confirm the act-* skills are present
• Codex: open /skills or mention $act-help where supported
• Cursor: you can also restart or reload Cursor, open Agent chat, and type /act-

/act-help

On clients that support slash commands, /act-help should show the ACT command navigator listing available commands, agents, and skills. In Codex, act-help is installed as a generated skill.

If you’re deciding between clients, see Platform Support.

What gets installed

The installer creates symlinks, plugin links, or generated files from the toolkit into your client’s config location:

CLI	Install location	Includes
Claude Code	~/.claude/, or the resolved Claude config directory	commands, agents, skills, and hooks
OpenCode	~/.config/opencode/	commands, agents, skills, and hooks plugin
Codex	~/.codex/skills/, ~/.codex/agents/, and ~/.codex/hooks/	generated skills, generated agents, and supported hooks
Cursor	~/.cursor/plugins/local/agentic-coding-toolkit	commands, agents, skills

Hooks

ACT installs automation hooks for supported clients:

• Session logging — tracks prompts and tool usage for debugging
• Dart auto-format — automatically formats .dart files after edits
• ACT statusline — shows context window usage (Claude Code only)

Note

Cursor’s current ACT installation does not include hooks. Codex hooks are supported for logging and Dart formatting, but do not include statusline or full Claude hook-event parity.

Updating

1. Pull the latest version

On clients that support ACT commands, run:

/act-update

This pulls the latest changes and shows you what’s new in the changelog.

If your current client does not expose /act-update, update ACT manually:

cd ~/.agentic-coding-toolkit && git pull --ff-only

2. Refresh integrations

After updating, re-run the installer to refresh symlinks, generated files, and plugin links:

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

Codex skill bodies are generated copies. Restart Codex if /skills or $act-* wording still looks stale after reinstalling.

If you installed ACT into a custom Claude config, rerun the installer with the same target:

cd ~/.agentic-coding-toolkit && ./scripts/install.sh --tool claude --config-dir ~/.claude-work

Or use the same CLAUDE_CONFIG_DIR value you used originally.

3. Restart your client session

Restart or reload your client to pick up the changes.

• Run /act-help to verify the install
• In Codex, open /skills or mention $act-help where supported
• On Cursor, you can also open Agent chat and type /act- to confirm the available act-* skills

Uninstalling

Claude Code

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

For a custom Claude config:

cd ~/.agentic-coding-toolkit && ./scripts/uninstall.sh --tool claude --config-dir ~/.claude-work

Or use the environment variable when it matches the config you want to remove ACT from:

CLAUDE_CONFIG_DIR=~/.claude-work ./scripts/uninstall.sh --tool claude

OpenCode

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

Codex

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

Cursor

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

This removes the ACT-managed links or local plugin for the selected client. The toolkit directory at ~/.agentic-coding-toolkit is not deleted — remove it manually if you no longer need it.

Note

After uninstalling Cursor support, fully close and restart Cursor if act-* skills still appear in Agent chat.