agentic-config

Project-agnostic, composable AI workflow automation via pi packages and Claude Code plugins.

Quick Start

Pi

Primary install from the current public release tag:

pi install "git:github.com/WaterplanAI/agentic-config@v0.3.0" -l

The -l flag installs it into the local project config. For a global/user install, remove -l.

For teams and automation, prefer the tagged git ref in committed .pi/settings.json so the rollout stays reproducible.

For local testing or development, use a branch ref instead of a tag, for example:

pi install "git:github.com/WaterplanAI/agentic-config@main" -l

If you prefer SSH transport, use the equivalent SSH git source for the same repository and ref.

The current git root install exposes the full shipped pi surface. Individual package-root installs remain useful for local package development and validation. npm publication remains future work.

Claude Code

claude plugin marketplace add WaterplanAI/agentic-config
# For dev branch: `claude plugin marketplace add </path/to/dev/branch>` OR `./dev.sh`

claude plugin install ac-workflow@agentic-plugins
claude plugin install ac-git@agentic-plugins
claude plugin install ac-qa@agentic-plugins
claude plugin install ac-tools@agentic-plugins
claude plugin install ac-meta@agentic-plugins
claude plugin install ac-safety@agentic-plugins
claude plugin install ac-audit@agentic-plugins

Note: Auto-updates are disabled by default for third-party marketplaces. Enable them via /plugins > Marketplaces > agentic-plugins > Enable auto-update to stay in sync with new releases automatically.

See Getting Started for pi and Claude Code setup.

Pi Packages

Pi is supported today through a validated root umbrella package installable from git refs, with local package-root installs for development and validation. Publishing the per-package npm surface remains future work.

For teams, prefer a committed .pi/settings.json pinned to a release tag. For local testing and development, use branch refs or direct local package paths as appropriate.

Upstream Pi attribution

agentic-config ships third-party packages for Pi. Pi itself, including the CLI, package loader, extension API, and runtime, is maintained upstream at pi.dev and badlogic/pi-mono. The package surface here imports upstream Pi APIs such as @mariozechner/pi-coding-agent and @mariozechner/pi-ai where needed.

See Upstream Pi attribution for source links and the runtime ownership boundary.

Inside @agentic-config/pi-ac-workflow, runtime ownership is deliberate: pimux is the package-owned tmux control plane, and ac-workflow-mux, ac-workflow-mux-ospec, and ac-workflow-mux-roadmap are structured wrappers on top of it. Generic long-lived tmux work stays on pimux; the shipped pi package no longer exposes a separate managed-agent surface.

Quick chooser:

• use pimux for a generic long-lived tmux worker, small team, or inspectable non-mux hierarchy
• use ac-workflow-mux for scout/planner/worker orchestration
• use ac-workflow-mux-ospec for one explicit spec-stage owner
• use ac-workflow-mux-roadmap for roadmap -> phase -> stage nesting

See pimux Workflow Topologies.

See the Pi Package Adoption Guide for the primary git-tag install path, branch-based dev installs, local package-root testing, and future npm distribution notes.

What is agentic-config?

A centralized configuration system shipped as pi packages and Claude Code plugins.

Future releases will extend the same plugin approach to additional tools (Cursor, Codex CLI, Gemini CLI, and Antigravity).

Core principles:

1. Project-agnostic -- Works in any codebase without modification
2. Composable -- Skills invoke other skills, creating compounding automation
3. Native distribution surfaces -- pi via pi install; Claude Code via claude plugin install

Plugins

Documentation

• Getting Started -- Install, setup, first use
• Plugin Catalog -- All 42 skills with composition patterns
• pimux Workflow Topologies -- pimux, mux, ospec, and roadmap hierarchy guide
• Distribution Guide -- pi git-tag installs, Claude marketplace rollout, dev branch installs, and future npm notes
• Pi Package Adoption Guide -- primary git-tag installs, branch-based dev installs, local package-root testing, and future npm distribution notes
• Upstream Pi attribution -- upstream Pi references and agentic-config package ownership boundaries
• Migration Guide v0.2.0 -- Migrate from v0.1.x
• Uninstall Legacy (v0.1.x) -- Remove legacy symlink wiring
• Full Documentation Index

Permissions

Claude Code MUX workflows (ac-workflow plugin) delegate to background agents via Task(run_in_background=True). Background agents cannot surface interactive permission prompts -- any unapproved tool is auto-denied. In pi, the mux-family uses the package-owned pimux runtime instead; see pimux Workflow Topologies.

Recommended: Run Claude Code with --dangerously-skip-permissions for MUX workflows:

claude --dangerously-skip-permissions

Alternatively, pre-authorize specific tools via CLI:

claude --allowedTools "Skill Bash Read Write Edit Grep Glob"

All plugins in this repository are designed and tested with full tool permissions enabled.

Contributing

See Contributing Guidelines.

For local pre-distribution pi package testing, start with the Pi Package Adoption Guide.

License

MIT License