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.2

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.2
File Size Uploaded Provenance
claudecord-0.4.2.tar.gz 963.8 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for claudecord 0.4.2
File
claudecord-0.4.2-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
claudecord-0.4.2-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details
claudecord-0.4.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details
claudecord-0.4.2-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
claudecord-0.4.2-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.2.tar.gz

Download URL claudecord-0.4.2.tar.gz
Size 963.8 kB
Tags Source
SHA-256 checksum
How to use checksums
d88856e92bf008688830d3a9206cf22286c6a860ddf98640b59f3e0dec90399d
BLAKE2b-256 checksum
How to use checksums
eb7abfedb11386211d898647da8a782cee680915745a34f215f497800a13352b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

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

Download URL claudecord-0.4.2-py3-none-win_amd64.whl
Size 7.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
251c97b4e8d14295da03f5734d65a29958d090eb538c9c3db78409a5a11a5c8f
BLAKE2b-256 checksum
How to use checksums
386725fa66194c91bc98ebe8a4292a64eeaee69daf99ecdd8de65bb5731241e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

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

Download URL claudecord-0.4.2-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
268ee29f9a8eb00cf49180b2228aed33d26f4b55f9fdd1277407a1f5f9e2341c
BLAKE2b-256 checksum
How to use checksums
a765bc8a083f0cc424d31ed828e8d905e1b8d65987249dd18a5ff18e4af6a3bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

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

Download URL claudecord-0.4.2-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
d2123ebff0d1be0547169332d598df2a6b8b15b3af1dc94d2867045e19007cdd
BLAKE2b-256 checksum
How to use checksums
c132f3ff845eb22dac6f9df495dd7370a9338c50fcaad57c982e1479f6d3296f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

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

Download URL claudecord-0.4.2-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
36d331fe071c9c8ba47ac7088d10b1b7be9b3000b4f66d7b12c9417eaf8bdd73
BLAKE2b-256 checksum
How to use checksums
9235f0b19011403020e1f018c01cee1a03fce2ac1d0184f8118821bf01f61735
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

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

Download URL claudecord-0.4.2-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
53b23a63b12e74f2693fabde77d61fcccd591bb2c4ad11ab2ae09aa5d2f3f4f0
BLAKE2b-256 checksum
How to use checksums
6b4ee65609aae20775e40f73756ca8c937a6146d4b753335d3059e461ec1d377
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 22, 2026.

Transparency log

Security for claudecord 0.4.2

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.2.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 22, 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