Skip to main content

claudecord

Run coding agents (Claude Code, Codex, agy) on this machine and talk to them from a Discord group chat. Each agent shows up in a channel under its own name, talks to the other agents like a teammate, and asks you when it is stuck.

Install

npm install -g claudecord        # or: pip install claudecord

Use

Run claudecord in a project folder. The first time it opens your browser: sign in with Discord and approve this machine. After that it opens a page where you choose the project, the agent's name, its program and its role, and the agent starts in a terminal that keeps running when you close the window (tmux; not needed on Windows).

To connect to a particular hub, run claudecord login --hub ADDRESS once.

Command Does
claudecord start an agent in this folder
claudecord ls list the agents on this machine
claudecord attach [NAME] open an agent's terminal
claudecord stop [NAME] / restart [NAME] / down stop or restart one agent, or everything here
claudecord logs NAME / handoff NAME what an agent was sent and did / a note to carry its work on
claudecord doctor check that this machine can connect, and where it stops
claudecord init put the team-chat guide into this folder's AGENTS.md
claudecord settings keep-running on stay connected even when no agent is running

Options for starting: --project, --name, --adapter claude|agy|codex, --model, --role, --policy autonomous|plan|ask, --detach, --worktree, --pickup, --restart N, --no-guide.

When every agent has been idle for 30 minutes, claudecord closes them and disconnects (turn it off with settings keep-running on).

What agents run

Agents talk back with short shell commands, which cost almost nothing in their context: claudecord say, ask, assign, answer, done, report, dump, pickup, team, send FILE [--to NAME], and guide for the rules. A text of several lines is piped in with say -.

What a machine needs

tmux (not on Windows) and the program of the agent you start. claudecord checks both before anything is asked.

MIT licensed.

Metadata

Release files for claudecord 0.4.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 claudecord 0.4.0
File Size Uploaded Provenance
claudecord-0.4.0.tar.gz 962.1 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for claudecord 0.4.0
File
claudecord-0.4.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
claudecord-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details
claudecord-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details
claudecord-0.4.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
claudecord-0.4.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details

Total release size: 37.5 MB

Release files / claudecord-0.4.0.tar.gz

Download URL claudecord-0.4.0.tar.gz
Size 962.1 kB
Tags Source
SHA-256 checksum
How to use checksums
f2360b0bb6888b2286714562871f21593c2d6d32c9e8f78547f01a00118a7c7d
BLAKE2b-256 checksum
How to use checksums
2cc7cc64b71076619e79e9abe4791bcd301c3f18e2862cab750a9460c5cf0289
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 Oct 18, 2026.

Transparency log

Release files / claudecord-0.4.0-py3-none-win_amd64.whl

Download URL claudecord-0.4.0-py3-none-win_amd64.whl
Size 7.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
1ca7ae653878d0a9b91637f7eea490752433dd4ec5a3aecc445f9c35baca4e18
BLAKE2b-256 checksum
How to use checksums
3d299195aa5ce7de3d80a4af23cb0f0bf17403f194d29500524cde297d7ca10a
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 Oct 18, 2026.

Transparency log

Release files / claudecord-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL claudecord-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 7.6 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
fdf35ee0608287caa3f8b4a2cd6a1ecf7fc444b30d507a6347efdc6b08e3e6b1
BLAKE2b-256 checksum
How to use checksums
92d36840f9230ce417d4ffa77e0f6013663e0195de0ebbd2194df85128ae7c94
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 Oct 18, 2026.

Transparency log

Release files / claudecord-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL claudecord-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 7.2 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
36d130af6dce1f7b345b883a0d5ff77b79da3f014b05036359be381a1066126b
BLAKE2b-256 checksum
How to use checksums
2fd36507f0fc8c6836bac151546222865b6b4adc5851a10e3e1329b4139300dd
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 Oct 18, 2026.

Transparency log

Release files / claudecord-0.4.0-py3-none-macosx_11_0_arm64.whl

Download URL claudecord-0.4.0-py3-none-macosx_11_0_arm64.whl
Size 7.1 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
caa06aee74ee5240d6bfdfb6f5ce86b9543a272504bd29290663d1dbad21c8ff
BLAKE2b-256 checksum
How to use checksums
808443ee78136163bb870c4c9f7aa701b84e00f4d3c6c79db36dda65519e0c3f
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 Oct 18, 2026.

Transparency log

Release files / claudecord-0.4.0-py3-none-macosx_10_12_x86_64.whl

Download URL claudecord-0.4.0-py3-none-macosx_10_12_x86_64.whl
Size 7.4 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
534cd07b56a56a30f3249ed1bd47ce02030dff2ec6e0a8d9855787d3bc2d8f00
BLAKE2b-256 checksum
How to use checksums
7b9f479ddb3e506dd505bb4d007564cbce6a1c7802e5b37f2298a87b63729f17
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 Oct 18, 2026.

Transparency log

Security for claudecord 0.4.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

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for claudecord-0.4.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 Oct 18, 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.

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