Skip to main content

Agent Toolchain

Standalone, zero-dependency pure-Python CLI suite for coding-agent toolchain compatibility verification, Skill synchronization, deployment diagnostics, and safe /tmp task directory management.

Current source version: 1.0.0.

Overview

agent-toolchain extracts the shared toolchain governance and workspace utilities into an independent package (agent_toolchain, published on PyPI as coding-agent-toolchain) decoupled from Git Finalizer's delivery engine while preserving full CLI and schema compatibility:

  • tool-skill-sync: Validates toolchain_compatibility.json (contract v6) and ToolSkillManifest v2 pins across context-loader, snapshot-runner, and git-finalizer; manages atomic ToolReleaseBundle staging, production activation/rollback, multi-client Skill exposure (codex, claude, gemini, cursor, qoder, qoder-cn), and read-only doctor deployment/instruction diagnostics (including external worktree-controller runtime checks).
  • tool-temp-dir: Creates and safely cleans up user-owned, registered /tmp/tool-task-<prefix>-<hex> task directories with strict symlink, device/inode, mount-point, active Unix socket, and explicit pytest basetemp guards.

Requirements

  • Python: >=3.12,<3.15 (pure Python standard library only; zero runtime dependencies).
  • OS & Tools: POSIX/Linux environment with git on PATH (for repository checks). Verified on Ubuntu 24.04 LTS with Python 3.12.

Installation

Install from a built wheel or source checkout:

uv tool install 'coding-agent-toolchain==1.0.0'

Or using pip:

pip install 'coding-agent-toolchain==1.0.0'

From a local source checkout, thin executable wrappers are available directly at the repository root:

./tool-skill-sync --version
./tool-temp-dir --version

Quick Start

Toolchain status, contract verification, and read-only diagnostics

# Inspect source contracts vs. active installed tools
tool-skill-sync status

# Read-only deployment & instruction freshness check
tool-skill-sync doctor --repo /path/to/checkout --summary

# Source-only contract validation for a tool
tool-skill-sync check --source-only git-finalizer

# Check or sync multi-client shared Skill links
tool-skill-sync skill-check
tool-skill-sync skill-install

Safe registered temporary task directories

# Create a registered /tmp/tool-task-<prefix>-<16hex> directory (0700)
tool-temp-dir create my-task

# Dry-run and cleanup an owned registered directory
tool-temp-dir dry-run-cleanup /tmp/tool-task-my-task-0123456789abcdef
tool-temp-dir cleanup /tmp/tool-task-my-task-0123456789abcdef

Pinned Compatibility Baseline (toolchain_compatibility.json v6)

The repository carries toolchain_compatibility.json (toolchain_contract_version: 6) and manifest pins under manifests/:

Tool Pinned Version Contract Version
context-loader 1.4.0 4
snapshot-runner 2.6.0 4
git-finalizer 2.0.0 10
worktree-controller external runtime CLI 37..62, storage 4..5, adapter 3

Development

just lint
just test
ruff check src tests
python3 -B -m unittest discover -s tests -p 'test_*.py' -v

License

Licensed under the Apache License 2.0.

Metadata

Release files for coding-agent-toolchain 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for coding-agent-toolchain 1.0.0
File Size Uploaded Provenance Actions
coding_agent_toolchain-1.0.0.tar.gz 81.9 kB With provenance Details for coding_agent_toolchain-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for coding-agent-toolchain 1.0.0
File Interpreter ABI Platform Actions
coding_agent_toolchain-1.0.0-py3-none-any.whl Python 3 none any Details for coding_agent_toolchain-1.0.0-py3-none-any.whl

Total release size: 138.5 kB

Release files / coding_agent_toolchain-1.0.0.tar.gz

Download URL coding_agent_toolchain-1.0.0.tar.gz
Size 81.9 kB
Tags Source
SHA-256 checksum
How to use checksums
9f073e7ae75f7987e69d8707782aa54b5ab66ac78f4bdedb56e2d561f063ca55
BLAKE2b-256 checksum
How to use checksums
1b4e08dadf918a3a3d822e48e6dc1c0f14880e33f3401e002525bd5e95cc9ae0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Release files / coding_agent_toolchain-1.0.0-py3-none-any.whl

Download URL coding_agent_toolchain-1.0.0-py3-none-any.whl
Size 56.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0070d6ef0b255ab5add0fe318211623f7556d35da4366b75b602df02924e1f75
BLAKE2b-256 checksum
How to use checksums
d8a2c66688d106147553d6b62347267872c3d8adbed5e3280e30e73e57cd911d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Security for coding-agent-toolchain 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for coding_agent_toolchain-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page