@mxmbt/agent-flow
v0.1.12
Published
Project-agnostic agent orchestration package and installer for Claude Code and Codex.
Maintainers
Readme
Agent Flow
Agent Flow installs and maintains project-local AI agent workflows for Claude Code and Codex.
npx @mxmbt/agent-flow initThe install writes:
.agent-flow/config.json- Claude Code targets under
CLAUDE.mdand.claude/** - Codex targets under
AGENTS.mdand.codex/** - shared agent artifact templates under
docs/templates/** - development wiki under
docs/wiki/**plus portable wiki tooling undertools/dev-wiki/** - helper scripts under
scripts/** - optional MCP config when enabled packs require it
Generated files are managed by Agent Flow and can be refreshed safely.
npx @mxmbt/agent-flow update
npx @mxmbt/agent-flow validate --strict
npx @mxmbt/agent-flow doctorQuick Start
npx @mxmbt/agent-flow init
npx @mxmbt/agent-flow doctor
npx @mxmbt/agent-flow validate --strictProfiles:
npx @mxmbt/agent-flow init --profile generic
npx @mxmbt/agent-flow init --profile webapp
npx @mxmbt/agent-flow init --profile finai.examplePacks:
npx @mxmbt/agent-flow pack list
npx @mxmbt/agent-flow pack add finance
npx @mxmbt/agent-flow pack add code-review-toolkit
npx @mxmbt/agent-flow pack remove financeInspection:
npx @mxmbt/agent-flow config list
npx @mxmbt/agent-flow config explain checks.defaultShellBlock
npx @mxmbt/agent-flow config explain wiki.searchCommand
npx @mxmbt/agent-flow render --json
npx @mxmbt/agent-flow sync --diffConcepts
- Core: stack-neutral lifecycle, agent contracts, canonical templates, validators, and shared helper scripts.
- Targets: Claude Code and Codex rendered files. They are mirrored from canonical content with explicit target adapters.
- Config: project-local facts such as branches, checks, artifact paths, runtime URLs, MCP choices, and unresolved
needsReviewfields. - Development Wiki: source-backed durable knowledge used in PLAN search, WIKI_ASSESSMENT pre-delivery validation, and periodic hygiene.
- Packs: optional capability modules such as
finance,cloudflare-worker,telegram,webapp,code-review-toolkit,code-review-graph,nextjs, anddesign. - Profiles: starter config overlays.
genericis neutral,webappenables browser QA/accessibility, andfinai.exampleproves product-specific assumptions can live outside core.
Tested Commands
The standard CI command is:
npm testIt builds the package, runs temp-repo install tests, validates mirror parity, exercises pack add/remove, and runs the universality scan.
Release-smoke commands before publishing:
npm run smoke:packageDocumentation
Development
npm install
npm test