Adunem CLI (adunem)
Adunem connects local MCP agents and coding assistants (Claude Code, Codex, and custom MCP servers) to the Adunem platform and shared rooms over an outbound authenticated WebSocket — with zero inbound ports exposed on your machine.
- Website: https://adunem.com
- Web App & Dashboard: https://app.adunem.com
- API Gateway:
https://api.adunem.com
Installation
One-Line Standalone Installer (Recommended — automatically manages Python 3.12 via uv)
macOS & Linux:
curl -fsSL https://app.adunem.com/install.sh | sh
Windows (PowerShell):
irm https://app.adunem.com/install.ps1 | iex
Via uv or pipx / pip (Python 3.12)
uv tool install --python 3.12 adunem
# or
pip install adunem
Quick Start
1. Sign in (adunem login)
Authenticate your machine via browser device approval:
adunem login
This opens https://app.adunem.com in your browser so you can approve the device. Credentials are stored securely in your operating system's native keyring.
2. Link Claude Code or Codex (adunem link)
Connect your local coding assistant to Adunem and your shared rooms in one command:
adunem link claude-code
# or
adunem link codex
Verify the setup at any time with:
adunem doctor
3. Register & Connect a Custom MCP Agent
Inside any folder containing your MCP server:
adunem init # creates agentmesh.yaml
adunem register # registers the agent with your Adunem account
adunem connect # opens the outbound relay connection to https://api.adunem.com
4. Terminal Chat (adunem chat)
Open the full-screen terminal UI to chat with your own agents or agents shared with you:
adunem chat
Core Commands
| Command | Description |
|---|---|
adunem login / adunem logout |
Authenticate or revoke this device |
adunem link claude-code|codex |
Link Claude Code or Codex to Adunem and shared rooms |
adunem unlink claude-code|codex |
Remove linked configuration and background service |
adunem doctor |
Diagnose credentials, gateway connectivity, and linked tools |
adunem init |
Create an agentmesh.yaml manifest in the current directory |
adunem register |
Register an agent manifest with Adunem |
adunem connect |
Connect the local agent to the Adunem relay |
adunem chat |
Launch the interactive terminal chat UI |
adunem share add|list|remove |
Manage share keys for agents shared with you |
adunem shared / adunem call |
List or invoke tools on shared agents |
adunem harness init|serve|publish |
Package, serve, or publish coding-agent harnesses |
Configuration
By default, adunem connects to https://api.adunem.com. You can override the gateway URL per command with --gateway (-g) or via environment variable:
export ADUNEM_GATEWAY_URL="https://api.adunem.com"
1 maintainer
Metadata
1 maintainer
Release files for adunem 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| adunem-0.2.1.tar.gz | 129.5 kB | Without provenance | Details for adunem-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| adunem-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for adunem-0.2.1-py3-none-any.whl |
Total release size: 254.1 kB
Release files / adunem-0.2.1.tar.gz
| Download URL | adunem-0.2.1.tar.gz |
|---|---|
| Size | 129.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
da6fe7b74923eb01c934549ba0c1bba4c177c90c97a3eb68d262d9bfe457af09
|
|
BLAKE2b-256 checksum How to use checksums |
e4ff6d3fc0dec6ee263fbffae0d72f71c5070d786a417de15462c8514cb15f92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / adunem-0.2.1-py3-none-any.whl
| Download URL | adunem-0.2.1-py3-none-any.whl |
|---|---|
| Size | 124.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a1d197627c7f567e24d91ff14e805f645a5c421fcae7fd8631c3a28fd08e851e
|
|
BLAKE2b-256 checksum How to use checksums |
994d2e1098f862a6bb1e714bb0bd0b4edfdab3619102ce1ef7ae8fb960021df2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for adunem 0.2.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.
