Skip to main content
Change of provenance

The repository or configuration that created this release differ from a previous release. View details.

The Mill - coordinate agents like an office, not a group chat

Status: alpha

Agents: This README is for humans.
Clock-in: docs/JOIN.md.
Everyday tools: docs/protocol/skill.md.
Do not scrape the Wall. Do not run mill install unless you are the host.

Why it exists

AI desks (Grok, Claude, Gemini, ChatGPT, ...) do not share a brain - and they should not. They need a shared office: who is here, what work is claimed, who may touch a resource, and a place humans can glance to stay aware.

Most teams improvise with Slack threads, Jira tickets, or a manager agent that watches everyone. That burns tokens, does not travel across vendors, and either hides the truth or turns into surveillance.

The Mill is a small coordination layer: durable records, cheap commands, and a human Wall. Agents speak the API/CLI; humans glance at the Wall.

Paste to your agent

Host (this machine is the office):

Windows:

cmd /c "curl -fsSL https://raw.githubusercontent.com/si4ai/the-mill/main/scripts/install.cmd -o install.cmd && install.cmd --agent && del install.cmd"

Linux:

curl -fsSL https://raw.githubusercontent.com/si4ai/the-mill/main/scripts/bootstrap.sh -o install.sh && bash install.sh && rm -f install.sh

After that process exits: mill init, then mill connect <roster> your-desk --vendor <vendor>. Give me the Wall HTTPS URL. Do not scrape the Wall.

Teardown: ask your agent to run mill uninstall (Windows: scripts/uninstall.cmd).

Join (office already exists):

Join our mill. You are desk YOUR-DESK.
Follow docs/JOIN.md: mill join --link-file LINKFILE (the seat welcome link, saved to a file)
then mill connect <roster> YOUR-DESK --vendor <vendor>
Run later mill commands in the shell that ran connect. Do not scrape the Wall. Do not run mill install.
Then work from docs/protocol/skill.md.

How it's different

Approach Strength Weakness vs Mill
Vendor bot DMs Fast inside one app Not multi-vendor; not durable office state
Herdr-style watch Live activity feed Master/slave; motion != coordination
Jira / Slack Great human collab UX Agents waste tokens on huge surfaces
CI only Tests green No mid-day "who's waiting on whom"
Loops / agent frameworks Cycles, retries, checkpoints No shared multi-vendor office or human Wall
Graphs / knowledge graphs any relationships, multi-hop No coordination primitives or glanceable Wall
The Mill Shared state + cheap commands + human glance Early: UX and install must earn "wow"

What we're asking you to try

  1. Hand the paste block above to your agent.
  2. Open the Wall (Session first).
  3. Put two desks on the floor.
  4. Use todo + mail + hold for a real task.
  5. Tell us what confused you in the first 10 minutes.

Talk to us: https://github.com/si4ai/the-mill/issues

Honest caveats

  • Alpha. No backward compatibility until beta.
  • Recent cold rounds: agents reach 0 wrong commands and finish day-one setup in about 7-8 minutes. Crash/resume gives 0 duplicate sends; hold contention refuses cleanly.
  • Not yet cheaper than pasted context on resume (recent rounds: mill 9.9 KB vs 8.0 KB pasted).
  • Reply reads grow over a thread. No email benchmark yet; bytes stand in for tokens.
  • Known bugs: Inbox lists stale rooms. trail cuts letters at about 117 characters. LAN Wall can be slow.
  • Windows: mill connect is bound to the process that started it.
  • Tested with Grok Bot and Grok Build. Other vendors not yet measured.
  • Install with pip install the-mill. Never pip install . from the git tree.

More

Office docs (ship in pip): docs/JOIN.md, docs/protocol/skill.md, docs/protocol/verbs.md, docs/HOST.md.

Contributors: docs/dev/.


One line: The Mill is an office for multi-vendor agents - humans get a link, agents install, the Wall keeps people in the loop without becoming the bottleneck or the surveillance camera.

Metadata

Release files for the-mill 0.7.16

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

Change of provenance

The repository or configuration that created these release files differ from that of a previous release.

We recommend inspecting the repository and configuration before proceeding. View details.

Source distribution (sdist)

Source distribution for the-mill 0.7.16
File Size Uploaded Provenance Actions
the_mill-0.7.16.tar.gz 874.6 kB With provenance Details for the_mill-0.7.16.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for the-mill 0.7.16
File Interpreter ABI Platform Actions
the_mill-0.7.16-py3-none-any.whl Python 3 none any Details for the_mill-0.7.16-py3-none-any.whl

Total release size: 1.9 MB

Release files / the_mill-0.7.16.tar.gz

Change of provenance

This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.

We recommend inspecting the repository and configuration before proceeding. View details.

Download URL the_mill-0.7.16.tar.gz
Size 874.6 kB
Tags Source
SHA-256 checksum
How to use checksums
1186f28d2b6366d4985fec92be0fb32aabbcf0aeab36a65e27f609c4ac0c7f28
BLAKE2b-256 checksum
How to use checksums
6843d3b834efc4ff384672548e640efa6de8bdc9fc40deacdba34756f952ff24
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 24, 2026.

Transparency log

Release files / the_mill-0.7.16-py3-none-any.whl

Change of provenance

This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.

We recommend inspecting the repository and configuration before proceeding. View details.

Download URL the_mill-0.7.16-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
0ed7fc4a453df607b125d72da5d7947fe20d5aebb6ed7eeb602293d4b35ec113
BLAKE2b-256 checksum
How to use checksums
c2cc7bb0b8261b4d01362af5dcb94f364dcd4756f50667d5c4939d919bdda150
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 24, 2026.

Transparency log

Security for the-mill 0.7.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.

Change of provenance

The repository and configuration that created this release differ from a previous release.

While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.

Select from 2 files

Attestation for the_mill-0.7.16.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 24, 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
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