Skip to main content
plural

plural

the shared room for your coding agent.

install · quick start · docs · security · contributing

License Release PyPI Python


one agent. one host. everyone in the room.

  • a shared live session — the host runs the agent on their machine with their own credentials. teammates join from a terminal and watch every reply, tool call and diff as it happens.
  • two ways to prompt — in open mode everyone talks to the agent directly. in review mode the host approves each prompt first. switch any time.
  • you approve what matters — write and exec actions always wait for the host, and a run started by a guest can never be waved through by a rule.
  • see who is doing what — participants, who is typing, a prompt queue, and an attribution on every turn.
  • tools you can follow — each call is one line. open it to see the live output of a command or a numbered diff.
  • full screen, in your terminal — a side panel, themes, mouse and keyboard, copy on select. one binary, no runtime to install.
  • your model, your login — anthropic by API key or Claude OAuth, any openai-compatible endpoint, or a local model through ollama.
  • event-sourced — an append-only log is the source of truth. reconnect, replay and audit come for free.
  • direct or relayed — connect over your network, or through a relay that never decides permissions and never stores content.

install

curl -fsSL https://raw.githubusercontent.com/Plural-Organization/Plural/main/install.sh | sh

macos and linux, arm64 and x64. windows through wsl. the script downloads two checksummed programs side by side, the plural client and the plural-host host (a frozen build with Python and the Anthropic and OpenAI sdks inside, so there is no uv, Python or dependency resolve at install time). Claude Code and Codex CLI need no key. to install the host from a package index instead, set PLURAL_HOST_PACKAGE.

quick start

start in the project you want the agent to work on:

cd your-project
plural

come back to a session later with plural -r (or plural -c for the latest one of this folder), and ask once from a script with plural -p "…". see usage.

the first line in the conversation is the room link. send it to a teammate, now or later: it does not expire, and you let each person in:

plural join "ws://…"

without a key the host runs a scripted demo agent. for a real model:

ANTHROPIC_API_KEY=sk-ant-… plural

or open F2 → Model → Claude OAuth → Sign in with Claude, then paste the code shown in the browser. Anthropic may bill this third-party usage from usage credits rather than subscription limits. To use your actual Claude Code login, run claude auth login in a terminal and select F2 → Model → Claude Code.

To use your Codex sign-in, run codex login in a terminal and select F2 → Model → Codex CLI. Choose a model available to your Codex account. Plural streams replies from one Codex session for the room while its host is running.

Claude OAuth defaults to Haiku 4.5. Newer Claude models may reject third-party OAuth requests even when login succeeds; use an Anthropic API key for those models.

/help lists the commands, F2 opens the settings, ctrl+o opens the tool details.

docs

usage · configuration · plugins · running on a server · wire protocol · threat model · design decisions · development

acknowledgements

plural learns from pi, opencode, hermes and herdr.

license

plural is free software, licensed under the GNU General Public License, version 3 or (at your option) any later version. Versions up to and including 0.2.16 were released under the Apache License 2.0 and stay available under it.

Metadata

Release files for plural-agent 0.2.25

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

Source distribution (sdist)

Source distribution for plural-agent 0.2.25
File Size Uploaded Provenance Actions
plural_agent-0.2.25.tar.gz 1.1 MB With provenance Details for plural_agent-0.2.25.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for plural-agent 0.2.25
File Interpreter ABI Platform Actions
plural_agent-0.2.25-py3-none-any.whl Python 3 none any Details for plural_agent-0.2.25-py3-none-any.whl

Total release size: 1.4 MB

Release files / plural_agent-0.2.25.tar.gz

Download URL plural_agent-0.2.25.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
90cf7bec3afaa2b66a5e63ddc1092a2f49b1b0a1bd0774e021f9e4a9351b44f9
BLAKE2b-256 checksum
How to use checksums
249f235f0fa2d7ce590de363698f07252e9def9175be48aec746a4f0d3b4964a
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 Nov 11, 2026.

Transparency log

Release files / plural_agent-0.2.25-py3-none-any.whl

Download URL plural_agent-0.2.25-py3-none-any.whl
Size 325.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c66f63473df0d75e2b61dddc9c1f1a94af87093f0ca9b383409ec8bdcfed6233
BLAKE2b-256 checksum
How to use checksums
90e7acbeee66e85cb3b325596d7a0edf28bf19cd5a8007f883d6748a18c0677e
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 Nov 11, 2026.

Transparency log

Security for plural-agent 0.2.25

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

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for plural_agent-0.2.25.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 Nov 11, 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

0.2.25 This release

2 release files Full provenance

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