arcgentic

Python CLI for the arcgentic Claude Code / Codex plugin.

arcgentic turns round-driven engineering discipline into mechanical checks: handoff validation, execute-round self-audit, external audit fact checks, cross-session handoff utilities, reference tracking, and lesson codification.

The package is the CLI surface of the hybrid monorepo. The plugin surface lives at repo root (skills/, agents/, hooks/, .claude-plugin/, .codex-plugin/); this package provides the Python implementation those skills shell out to.

Install

Requires Python 3.13+.

pipx install arcgentic

# or
uv tool install arcgentic

arcgentic --help

Install from source

git clone https://github.com/Arch1eSUN/Arcgentic.git arcgentic
cd arcgentic/toolkit
python3 -m pip install -e ".[dev]"
arcgentic --help

CLI commands

Round implementation helpers

arcgentic plan-round-impl --round R1.0 --type substrate-touching --anchor <sha40>
arcgentic execute-round-impl --round R1.0 --handoff docs/superpowers/plans/R1.0.md

Audit and gate checks

arcgentic audit-check docs/audits/R1.0.md --strict-extended
arcgentic quality-gate-enforce --repo-root .
arcgentic validate-handoff docs/superpowers/plans/R1.0.md

Lessons, references, and handoff

arcgentic codify-lesson --audit-dir docs/audits
arcgentic track-refs add references/example --owner-repo owner/repo --round R1 --usage-evidence '{"pattern_only": true}'
arcgentic cross-session-handoff read

Development

cd toolkit
python3 -m pip install -e ".[dev]"

Run quality gates from toolkit/:

mypy --strict src/ tests/
pytest --tb=no
ruff check .

Repository

Homepage: https://github.com/Arch1eSUN/Arcgentic

Full plugin README: https://github.com/Arch1eSUN/Arcgentic#readme

Layout

  • src/arcgentic/adapters/ — IDE adapter Protocol + implementations
  • src/arcgentic/skills_impl/ — skill implementation backends
  • src/arcgentic/audit_check.py — mechanical audit fact checker
  • src/arcgentic/source_rules.py — Moirai-derived source-rule contract validators
  • src/arcgentic/utils/pattern_detection.py — repeated audit-pattern clustering for lessons
  • src/arcgentic/cli.py — command-line bridge for skills, gates, and validators
  • tests/unit/, tests/integration/ — pytest suites

Project links

Data verified by PyPI on Aug 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for archiesun from gravatar.com archiesun

Credits

Author: Arc Studio

GitHub Statistics

Data verified by PyPI on Aug 12, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.13

Provides Extra

dev mcp

Tags

agentic-harness claude-code ide-adapter round-driven-development

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

arcgentic-2.2.0.tar.gz (126.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

arcgentic-2.2.0-py3-none-any.whl (91.7 kB view details)

Uploaded Python 3

File details

Details for the file arcgentic-2.2.0.tar.gz.

File metadata

  • Download URL: arcgentic-2.2.0.tar.gz
  • Upload date:
  • Size: 126.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for arcgentic-2.2.0.tar.gz
Algorithm Hash digest
SHA256 a166aad2ae90bae316058ec722cf865399eef14ea884ec0e4ba1e974e9721a24
MD5 7bab8d70ada83cdbd0ac3b288648ff2d
BLAKE2b-256 50ec0214eba8b27e8b1d8a23a26c08422d95b3006f87fef2e095cea53ad469f4

See more details on using hashes here.

Provenance

The following attestation bundles were made for arcgentic-2.2.0.tar.gz:

Publisher: publish-python.yml on Arch1eSUN/Arcgentic

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file arcgentic-2.2.0-py3-none-any.whl.

File metadata

  • Download URL: arcgentic-2.2.0-py3-none-any.whl
  • Upload date:
  • Size: 91.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for arcgentic-2.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0147950bc2fa9d30cccb5bf36d87e44402f2a98e4246bd782b7d6c972237aa12
MD5 38f4e11760d9285ce345b6e7834c0854
BLAKE2b-256 da5894232eb97f8c1b3612ad76be6dfcf77b0106129857d27a8ec3bcf3b07020

See more details on using hashes here.

Provenance

The following attestation bundles were made for arcgentic-2.2.0-py3-none-any.whl:

Publisher: publish-python.yml on Arch1eSUN/Arcgentic

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page