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

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.1
File Size Uploaded Provenance
claudecord-0.4.1.tar.gz 963.3 kB With provenance Details

Built distributions (wheels)

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

Download URL claudecord-0.4.1.tar.gz
Size 963.3 kB
Tags Source
SHA-256 checksum
How to use checksums
4c63f8f100ab288d42489ecfd0b853acd5ca40bcdcdfa8f795f2d498a8c66945
BLAKE2b-256 checksum
How to use checksums
dad2c83ff65896dc28901e2be791e625aacf8fe42e87ed4f312bb68abb1afeeb
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 19, 2026.

Transparency log

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

Download URL claudecord-0.4.1-py3-none-win_amd64.whl
Size 7.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
4c1f01b82bb45c82ad5a29006e926dc4555c20fdbe6dc58ffdeb58037a9bf5f8
BLAKE2b-256 checksum
How to use checksums
bba2addf2956cd4b8c650fa64634cbfc6f8b17aaf9fb9f1c35b6b060e43d201c
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 19, 2026.

Transparency log

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

Download URL claudecord-0.4.1-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
0329f8e79fe0435a0f492039a616a4cdd0aa84d0ce21ea1f995e7a73b85bd9d9
BLAKE2b-256 checksum
How to use checksums
a27b5d8fe07366f0d92167b6711516b9c2c8dcdf136186a03ce62fd0fcdb8e9d
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 19, 2026.

Transparency log

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

Download URL claudecord-0.4.1-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
e1a1e9764b5efd9ee253667c653f6152fbb829b7175ecbf890c79f0b6f67f4ff
BLAKE2b-256 checksum
How to use checksums
fa800cbd5aeb46df085c59e75ae882485ab88963aba23ed70e2906e14d6859df
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 19, 2026.

Transparency log

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

Download URL claudecord-0.4.1-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
df9303a862db0a569012d0025d23228ee3f9f47dcb24fa427891f445bce1a206
BLAKE2b-256 checksum
How to use checksums
b22af29ed175622bdef9ff4dec48eeba96297f3484082cf0b47f709e5e9839ba
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 19, 2026.

Transparency log

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

Download URL claudecord-0.4.1-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
f7caf968c870450418f785b5e511b2642ed5085ca5eb4fc60a6b1f084af84076
BLAKE2b-256 checksum
How to use checksums
14648582f29d3056bd3ba26f66e05f31fe821742a6e1a27803ceb09aff72b367
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 19, 2026.

Transparency log

Security for claudecord 0.4.1

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.1.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 19, 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.

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