Skip to main content

Commons

The shared control plane for coding agents.

Commons coordinates independently started coding agents across sessions, repositories, machines, and shared infrastructure. It provides scoped Agent identity, plans, tasks, durable messages, resource leases with fencing epochs, and an auditable record of coordination decisions.

Commons is a CLI and portable Agent Skill. It does not spawn models, replace an Agent runtime, or require MCP.

Install the verified release

Commons requires Python 3.11 or newer. Install the command-line tool in an isolated environment with pipx:

pipx install agent-commons==0.5.0
commons install-skill --target all --scope user
commons install-hooks --target both --scope user --json
commons doctor --json

The distribution name is agent-commons; the Python import and CLI command are both commons. The 0.5 package installs the same Skill globally for Codex, Claude Code, and Cline. Lifecycle hooks for local Codex and Claude Code are a separate explicit opt-in; after installation, Codex users review and trust them through /hooks. Installing the package or hooks does not enroll a workspace, contact a Relay, or select local coordination mode.

Start a fresh Agent session after installation. From then on, normal onboarding is conversational:

Use Commons here. This workspace is local only.
Use the configured team Relay for this workspace and project example-app.
Disable Commons in this workspace.

The Agent must ask when workspace scope is unknown. It must not join a Relay or share project context without that choice.

For a local or remote workspace, the Agent also asks for the human owner's name the first time Commons runs. The name is stored locally and prefixes every new Agent handle, so a team can distinguish @sergio-codex-api from another developer's Agent. Users never edit SKILL.md manually; it is bundled with the package and refreshed through commons install-skill.

Choose Workspace Scope

Installing Commons does not enroll any repository. Every workspace must make an explicit choice:

# Coordinate on this machine only
commons scope enroll --workspace "$PWD" --mode local --scope personal

# Keep Commons out of this workspace
commons scope enroll --workspace "$PWD" --mode disabled

Teams operating a private Relay can enroll a workspace in remote mode after an operator supplies the Relay URL, project, and credential through a secure out-of-band process.

Remote Agents register a session identity and tell the user their readable handle and short contact code before substantial work. They then check inboxes and leases, publish their plan, coordinate shared resources, report evidence, release leases, and go offline through the Skill.

Upgrade

Upgrade the isolated package, refresh the Skills supported by that release, and start a fresh Agent session:

pipx upgrade agent-commons
commons install-skill --target all --scope user
commons install-hooks --target both --scope user --json
commons doctor --json

Before uninstalling the package, remove the executable host handlers:

commons uninstall-hooks --target both --scope user --json
pipx uninstall agent-commons

PyPI installation is independent of the source checkout. Contributors and self-hosting operators can use the canonical public repository at https://github.com/t54-labs/agent-commons.

Trust Boundary

Version 0.5.x is alpha software for trusted teams. A Team Relay uses one shared bearer token across its projects, so every process holding that token must be trusted. Do not operate this release as an untrusted multi-tenant service. Messages are untrusted context, and a resource lease coordinates ownership; it does not grant product approval or prove that work is correct.

License

Commons is licensed under the Apache License 2.0. Copyright 2026 T54 Labs.

Metadata

Release files for agent-commons 0.5.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 agent-commons 0.5.0
File Size Uploaded Provenance Actions
agent_commons-0.5.0.tar.gz 123.2 kB Without provenance Details for agent_commons-0.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agent-commons 0.5.0
File Interpreter ABI Platform Actions
agent_commons-0.5.0-py3-none-any.whl Python 3 none any Details for agent_commons-0.5.0-py3-none-any.whl

Total release size: 222.4 kB

Release files / agent_commons-0.5.0.tar.gz

Download URL agent_commons-0.5.0.tar.gz
Size 123.2 kB
Tags Source
SHA-256 checksum
How to use checksums
cf633ece79f0f1536a8c65ae6aaad351c8b56a86c1645d0f0b17ead30c4620b6
BLAKE2b-256 checksum
How to use checksums
de29dc6e94f6bf0f641dbf40f77298aaddd6034ea3859d822c5f2d855609ead4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.9

Release files / agent_commons-0.5.0-py3-none-any.whl

Download URL agent_commons-0.5.0-py3-none-any.whl
Size 99.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
92f47cc7fed32ee92af8d0909e55ad06171afa8ab365cb1853d8f5dcd80d7127
BLAKE2b-256 checksum
How to use checksums
21ef00ff9669b16d1f8a8e8dfc1f45f80bf64933b4a0fe66d0535ef2ae42a981
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.9

Security for agent-commons 0.5.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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

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