Installation

Prerequisites

Before installing ACT, make sure you have:

• Claude Code CLI and/or OpenCode CLI — the AI coding assistant that ACT extends
• Git — for version control and worktree support
• Flutter SDK — for Flutter/Dart projects (install guide)
• Node.js — required for ACT hooks

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.

2. Run the installer

For Claude Code

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

For OpenCode

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

If you use both CLIs, run both commands.

Note

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

• Creates symlinks for commands, agents, and skills in ~/.claude/ (Claude Code) or ~/.config/opencode/ (OpenCode)
• Installs hooks into ~/.claude/settings.json or an OpenCode plugin
• Points everything back to ~/.agentic-coding-toolkit

3. Verify

Start a new Claude Code or OpenCode session and run:

/act:help

You should see the ACT command navigator listing all available commands.

What gets installed

The installer creates symlinks from the toolkit to your CLI’s config directory:

CLI	Symlink location	Includes
Claude Code	~/.claude/	commands, agents, skills, and hooks
OpenCode	~/.config/opencode/	commands, skills, and hooks plugin

Hooks

ACT installs automation hooks for your CLI:

• 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)

Updating

1. Pull the latest version

Within a Claude or OpenCode session:

/act:update

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

2. Refresh symlinks

After updating, re-run the installer to refresh symlinks:

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

(Or --tool opencode if using OpenCode.)

3. Restart your CLI session

Restart Claude Code or OpenCode to pick up the changes, then verify with /act:help.

Uninstalling

Claude Code

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

OpenCode

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

This removes all symlinks and hooks. The toolkit directory at ~/.agentic-coding-toolkit is not deleted — remove it manually if you no longer need it.