Claude Code

Claude Code is the most direct ACT experience today. It supports ACT skills, commands, agents, and hooks with the least translation in the docs.

Install

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

Custom Config Directories

ACT supports Claude Code installs into a non-default config directory. Use this when you run separate Claude profiles, isolated environments, or experimental configs:

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

ACT also respects Claude Code’s CLAUDE_CONFIG_DIR environment variable:

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

If both are set, --config-dir wins.

What Gets Installed

Location	Includes
`~/.claude/commands/`	Symlinked ACT command files
`~/.claude/skills/`	Symlinked canonical ACT skill directories
`~/.claude/agents/`	Generated Claude-compatible ACT agent files
`~/.claude/hooks/`	Copied ACT hook core scripts and Claude adapters
`~/.claude/settings.json`	ACT hook entries merged into Claude Code settings
`~/.config/agentic-coding-toolkit/`	Shared ACT settings and copied runtime helper

If --config-dir or CLAUDE_CONFIG_DIR is set, that Claude config directory is used instead of ~/.claude.

Verify

Start a new Claude Code session from the same environment where you installed ACT, then run:

/act-help

You should see the ACT help navigator listing commands, agents, and skills.

Skills

Invoke ACT skills directly by name:

/act-workflow-spec "add a settings screen"
/act-workflow-plan ai_specs/settings-spec.md
/act-git-push-make-pr

Commands and Agents

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

Hooks

ACT installs Claude-compatible hooks through Claude’s settings system. That includes ACT hook automation and ACT statusline support.

Permissions

Claude Code supports file-based permission configuration through .claude/settings.json. For the recommended ACT setup, see Permissions & Safety.

Update

After updating ACT, rerun the installer to refresh symlinks, generated agent files, copied hook scripts, and merged hook entries:

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

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

Uninstall

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

Use the same --config-dir or CLAUDE_CONFIG_DIR target if you installed into a custom Claude config.

Uninstall removes ACT-owned command symlinks, skill symlinks, generated agent files, hook entries, and copied hook scripts. It leaves shared ACT settings under ~/.config/agentic-coding-toolkit untouched.

Best Fit

You want the smoothest direct-skill workflow
You want the full ACT surface today
You want ACT’s hook automation plus statusline support