Installation

Prerequisites

Before installing ACT, make sure you have:

• One supported AI client — Antigravity, Claude Code, Codex CLI, Cursor, GitHub Copilot CLI, or OpenCode
• 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

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

Lite

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

Pro

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

Run the command for your AI client:

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

GitHub Copilot CLI version

Copilot support requires GitHub Copilot CLI 1.0.63 or newer.

How to 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.

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:

• Installs ACT skills for Antigravity under ~/.gemini/skills
• Creates Claude Code integrations for ACT skills and agents
• Creates generated Codex integrations for ACT skills, agents, and supported hooks
• Installs ACT’s local Cursor plugin for skills
• Creates generated GitHub Copilot CLI integrations for ACT skills, agents, and supported hooks
• Creates OpenCode integrations for ACT skills and agents
• 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:

• Antigravity: start agy, run /skills, and confirm ACT skills appear
• Claude Code: run /act-help
• Codex: open /skills or mention $act-help where supported
• Cursor: you can also restart or reload Cursor, open Agent chat, and type /act-
• GitHub Copilot CLI: run /act-help, open /skills, or use /agent to select a research agent
• OpenCode: run /act-help, or open /skills and confirm the act-* skills are present

/act-help

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

For Antigravity, /skills is the primary verification. You can also inspect ~/.gemini/skills if you need to confirm the install location.

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

Optional: Install Official Dart and Flutter Skills

ACT focuses on workflow, planning, verification, and Flutter-specific agent patterns. The official Dart and Flutter team skills are maintained separately by the Dart and Flutter teams, and can be installed alongside ACT.

They are not bundled with ACT, but ACT includes a helper that shows the upstream install, update, and uninstall commands:

node ~/.config/agentic-coding-toolkit/bin/act-run-script.js scripts/install-official-dart-flutter-skills.sh

This will show commands such as:

npx skills add flutter/skills --skill '*'
npx skills add dart-lang/skills --skill '*'

Use this if you want both ACT’s workflow-oriented skills and the official upstream Dart/Flutter skills available in the same AI coding client.

Learn more here:

• Flutter Agent Skills
• Agent Skills for Dart

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
Antigravity	~/.gemini/skills/	skills
Claude Code	~/.claude/, or the resolved Claude config directory	skills, agents, and hooks
Codex	~/.codex/skills/, ~/.codex/agents/, and ~/.codex/hooks/	generated skills, generated agents, and supported hooks
Cursor	~/.cursor/plugins/local/agentic-coding-toolkit	skills, agents
GitHub Copilot CLI	~/.copilot/skills/, ~/.copilot/agents/, and ~/.copilot/hooks/	generated skills, generated agents, and supported hooks
OpenCode	~/.config/opencode/	skills, agents, and hooks plugin

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 and GitHub Copilot CLI 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 skills, run:

/act-update

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

Alternatively, update ACT manually from the command line:

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 antigravity
cd ~/.agentic-coding-toolkit && ./scripts/install.sh --tool claude
cd ~/.agentic-coding-toolkit && ./scripts/install.sh --tool codex
cd ~/.agentic-coding-toolkit && ./scripts/install.sh --tool cursor
cd ~/.agentic-coding-toolkit && ./scripts/install.sh --tool copilot
cd ~/.agentic-coding-toolkit && ./scripts/install.sh --tool opencode

Codex and GitHub Copilot CLI skill bodies are generated copies. Restart Codex if /skills or $act-* wording still looks stale after reinstalling. In Copilot, run /skills reload or restart Copilot if /skills still looks stale.

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
• In GitHub Copilot CLI, run /act-help, open /skills, or run /skills reload after reinstalling

Uninstalling

Run the command for your AI client:

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

Remove ACT from a separate Claude Code config directory

Use the same custom directory option you used during installation:

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

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

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.