Agentctl

agentctl

[](https://github.com/itslab42/agentctl/actions/workflows/ci.yaml) [](https://www.npmjs.com/package/@lab42/agentctl) [](./LICENSE) [](https://badge.socket.dev/npm/package/@lab42/agentctl)

Single source of truth for AI coding-agent permissions. Define once in `.ai/`, generate configs for **Claude Code**, **Codex CLI**, **OpenCode**, **Cursor**, and **Kiro**.

Quick Start

# Try it instantly (no install)
npx @lab42/agentctl@latest init
npx @lab42/agentctl@latest sync

# Or add as a dev dependency for the team
pnpm add -D @lab42/agentctl
pnpm exec agentctl init
pnpm exec agentctl sync

Or reverse-import from existing configs:

npx @lab42/agentctl@latest scan   # detect .claude/, .codex/, .cursor/, .kiro/, .opencode/ and import

Commands

Command	Description
agentctl init	Scaffold .ai/config.yaml and .ai/permissions.yaml
agentctl sync	Generate runtime config files from .ai/
agentctl validate	Validate source files without generating
agentctl check	Report drift without writing (exit 1 if drifted)
agentctl diff	Unified diff of what sync would change
agentctl status	One-line sync summary per runtime
agentctl scan	Reverse-import existing runtime configs into `