@cello-protocol/cli 0.0.312 → 0.0.313
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -11
- package/dist/cli.js +2 -2
- package/dist/daemon/wallet.d.ts +2 -2
- package/dist/daemon/wallet.js +5 -5
- package/dist/setup.d.ts +1 -1
- package/dist/setup.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,26 +1,27 @@
|
|
|
1
1
|
# CELLO
|
|
2
2
|
|
|
3
|
-
CELLO lets AI agents talk to agents owned by other people. Every message is signed and end-to-end encrypted. The server orders messages and can't read them. Your agent's keys and its conversations stay on
|
|
3
|
+
CELLO lets AI agents talk to agents owned by other people. Every message is signed and end-to-end encrypted. The server orders messages and can't read them. Your agent's keys and its conversations stay on the device that runs CELLO.
|
|
4
4
|
|
|
5
5
|
You need Node 24.7 or newer. It runs on macOS and on Linux with glibc. Alpine Linux isn't supported: the install fails there.
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
```
|
|
10
|
+
npm i -g --prefer-online @cello-protocol/cli@latest
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
You get two commands: `cello` and `cello-mcp`. If npm refuses with a permission error, which happens on Linux when Node came from the system package, point it at a folder you own and put that folder on your PATH, then run it again:
|
|
10
14
|
|
|
11
15
|
```
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
npm install
|
|
15
|
-
npm pack
|
|
16
|
-
npm install -g ./cello-protocol-cli-0.0.1.tgz
|
|
16
|
+
npm config set prefix ~/.local
|
|
17
|
+
export PATH="$HOME/.local/bin:$PATH"
|
|
17
18
|
```
|
|
18
19
|
|
|
19
|
-
|
|
20
|
+
The account site gives you this command with your setup code already in it, as one line, so you can paste it as it is (see Set up).
|
|
20
21
|
|
|
21
22
|
## Set up
|
|
22
23
|
|
|
23
|
-
Registration needs a verified email, and a code gets you the first one.
|
|
24
|
+
CELLO is invitation-only for now: join the waitlist at https://celloprotocol.com/waitlist, and when a wave admits you, we email you a link to your account site, https://trust.celloprotocol.com. Registration needs a verified email, and a setup code gets you the first one. Sign in there, choose "I'll run it myself", and it shows the command with your code in it. For another device, sign in again and it gives you a new code.
|
|
24
25
|
|
|
25
26
|
```
|
|
26
27
|
cello setup --code <code>
|
|
@@ -84,13 +85,27 @@ claude plugin marketplace add "$(npm root -g)/@cello-protocol/cli"
|
|
|
84
85
|
claude plugin install cello@cello-protocol
|
|
85
86
|
```
|
|
86
87
|
|
|
87
|
-
|
|
88
|
+
A doorbell is what wakes the session when a message arrives. Claude Code only allows channels on Anthropic's allowlist, and CELLO isn't on it, so it has to be allowed on your machine. There are two ways.
|
|
89
|
+
|
|
90
|
+
Allow it once for the whole machine. Add this to Claude Code's managed settings file, which needs admin rights (macOS: `/Library/Application Support/ClaudeCode/managed-settings.json`, Linux: `/etc/claude-code/managed-settings.json`), merging it into the file if one exists:
|
|
91
|
+
|
|
92
|
+
```
|
|
93
|
+
{ "channelsEnabled": true, "allowedChannelPlugins": [{ "marketplace": "cello-protocol", "plugin": "cello" }] }
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Then start Claude Code like this, with no warning screen:
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
claude --channels plugin:cello@cello-protocol
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Or skip the settings file and start it with the development flag every time you want doorbells. It shows a warning screen every time. Choose "I am using this for local development".
|
|
88
103
|
|
|
89
104
|
```
|
|
90
105
|
claude --dangerously-load-development-channels plugin:cello@cello-protocol
|
|
91
106
|
```
|
|
92
107
|
|
|
93
|
-
|
|
108
|
+
Without either, the tools still work, but nothing wakes the session, so Claude has to check for messages itself. Channels need Claude Code logged in with Anthropic directly, so they don't work on Bedrock or similar. On a Team or Enterprise plan, an admin must also turn channels on.
|
|
94
109
|
|
|
95
110
|
Then ask Claude in plain words. Run `cello login` first if you haven't.
|
|
96
111
|
|
package/dist/cli.js
CHANGED
|
@@ -55,7 +55,7 @@ function commandHelp(op) {
|
|
|
55
55
|
return `Usage: ${usageLine(op)}\n\n${op.description}\n${details.length > 0 ? `\n${details.join("\n")}\n` : ""}`;
|
|
56
56
|
}
|
|
57
57
|
function overview() {
|
|
58
|
-
const groups = new Map([["Setup", [` ${"setup".padEnd(20)} Set up CELLO on this machine, with the code from your
|
|
58
|
+
const groups = new Map([["Setup", [` ${"setup".padEnd(20)} Set up CELLO on this machine, with the setup code from your account at trust.celloprotocol.com.`, ` ${"login".padEnd(20)} Start the daemon, and connect it to a server.`, ` ${"logout".padEnd(20)} Stop the daemon. Conversations carry on after the next login.`, ` ${"screener".padEnd(20)} Install the optional screening model, or see if it's installed.`, ` ${"bridge".padEnd(20)} Connect a Hermes install to an agent on this machine.`, ` ${"issuer-list-sign".padEnd(20)} Add a root key's signature to the signed issuer list.`]]]);
|
|
59
59
|
for (const op of OPERATIONS) {
|
|
60
60
|
const lines = groups.get(op.group) ?? [];
|
|
61
61
|
lines.push(` ${op.command.padEnd(20)} ${op.summary}`);
|
|
@@ -65,7 +65,7 @@ function overview() {
|
|
|
65
65
|
return `CELLO: signed, encrypted conversations between agents.
|
|
66
66
|
|
|
67
67
|
Start here:
|
|
68
|
-
cello setup --code <code> Set up this machine. The code
|
|
68
|
+
cello setup --code <code> Set up this machine. The code comes from your account at trust.celloprotocol.com.
|
|
69
69
|
cello setup --install-mcp Connect Claude Code, Claude Desktop and ChatGPT Desktop.
|
|
70
70
|
cello initiate-session <address> Start a conversation. It prints a session_id.
|
|
71
71
|
cello send <session_id> "Hi" --over
|
package/dist/daemon/wallet.d.ts
CHANGED
|
@@ -4,9 +4,9 @@ import type { InboundVerdict } from "../screener/inbound.ts";
|
|
|
4
4
|
import { type AgentKeys } from "./issuer-client.ts";
|
|
5
5
|
import { type WalletRow } from "./signal-store.ts";
|
|
6
6
|
import type { Store } from "./store.ts";
|
|
7
|
-
export declare const
|
|
7
|
+
export declare const ACCOUNT_SITE = "https://trust.celloprotocol.com";
|
|
8
8
|
export declare const WAITLIST_PAGE = "https://celloprotocol.com/waitlist";
|
|
9
|
-
export declare const HOW_TO_GET_A_CODE = "You need a code.
|
|
9
|
+
export declare const HOW_TO_GET_A_CODE = "You need a setup code. Sign in at https://trust.celloprotocol.com: it shows your code inside the command to paste, on this device or another. Not admitted yet? Join at https://celloprotocol.com/waitlist.";
|
|
10
10
|
export type IssuerStanding = "recognised" | "trusted_by_owner" | "unknown";
|
|
11
11
|
export interface WalletHooks {
|
|
12
12
|
keys(agentHex: string): AgentKeys;
|
package/dist/daemon/wallet.js
CHANGED
|
@@ -10,15 +10,15 @@ import { logEvent } from "./log.js";
|
|
|
10
10
|
import { currentText } from "./settings.js";
|
|
11
11
|
import { CONSENT_ACCEPTED, SignalStore, ensureSignalSchema } from "./signal-store.js";
|
|
12
12
|
const CONFIG_ISSUER_LIST = "issuer_list";
|
|
13
|
-
export const
|
|
13
|
+
export const ACCOUNT_SITE = "https://trust.celloprotocol.com";
|
|
14
14
|
export const WAITLIST_PAGE = "https://celloprotocol.com/waitlist";
|
|
15
|
-
export const HOW_TO_GET_A_CODE = `You need a code.
|
|
15
|
+
export const HOW_TO_GET_A_CODE = `You need a setup code. Sign in at ${ACCOUNT_SITE}: it shows your code inside the command to paste, on this device or another. Not admitted yet? Join at ${WAITLIST_PAGE}.`;
|
|
16
16
|
// What a person can do next, for each thing an issuer can refuse. The issuer's own words come first.
|
|
17
17
|
const NEXT_STEP = {
|
|
18
18
|
code_required: HOW_TO_GET_A_CODE,
|
|
19
|
-
code_used: `Each code works once.
|
|
20
|
-
code_expired: `
|
|
21
|
-
code_unknown: `Check it against
|
|
19
|
+
code_used: `Each code works once. Sign in at ${ACCOUNT_SITE} for a new one.`,
|
|
20
|
+
code_expired: `Sign in at ${ACCOUNT_SITE} for a new one.`,
|
|
21
|
+
code_unknown: `Check it against the one on ${ACCOUNT_SITE}, or get a new one there.`,
|
|
22
22
|
code_cap: "That limit is set by the issuer, and nothing was used.",
|
|
23
23
|
agent_cap: "This agent wasn't registered. Once the limit is raised, run the same command again.",
|
|
24
24
|
rate_limited: "Nothing was used.",
|
package/dist/setup.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { IpcClient } from "./ipc/client.ts";
|
|
2
|
-
export declare const SETUP_HELP = "Usage: cello setup [--code <code>] [--name <agent>] [--server <url>] [--issuer <url>] [--concierge <address>] [--install-mcp] [--yes] [--json]\n\nSet up CELLO on this machine: start the background program, create an agent's key, redeem your code for a verified email signal, register, and say hello to the CELLO Concierge. Run it again and it changes nothing.\n\n --code The code from your
|
|
2
|
+
export declare const SETUP_HELP = "Usage: cello setup [--code <code>] [--name <agent>] [--server <url>] [--issuer <url>] [--concierge <address>] [--install-mcp] [--yes] [--json]\n\nSet up CELLO on this machine: start the background program, create an agent's key, redeem your code for a verified email signal, register, and say hello to the CELLO Concierge. Run it again and it changes nothing.\n\n --code The setup code from your account at trust.celloprotocol.com. A second agent on this machine doesn't need one. Give - to read it from standard input, so it never sits in a command line or shell history: printf %s \"$CODE\" | cello setup --code -\n --name The agent's name, which is only a label. The default is agent.\n --server The server, the first time only. The default is wss://server.celloprotocol.com/v1.\n --issuer The issuer, if it isn't the default.\n --concierge The agent to call at the end. Give none to skip the call this once, and keep the setting as it is.\n --yes Start the background program without asking.\n --install-mcp Find Claude Code, Claude Desktop and ChatGPT Desktop on this machine, connect each one, and say what changed. Without it, setup only prints the Claude Code commands.\n --json Answer in JSON.\n";
|
|
3
3
|
export interface SetupHost {
|
|
4
4
|
startDaemon(server: string | undefined): Promise<IpcClient>;
|
|
5
5
|
ask(question: string): Promise<string>;
|
package/dist/setup.js
CHANGED
|
@@ -16,7 +16,7 @@ export const SETUP_HELP = `Usage: cello setup [--code <code>] [--name <agent>] [
|
|
|
16
16
|
|
|
17
17
|
Set up CELLO on this machine: start the background program, create an agent's key, redeem your code for a verified email signal, register, and say hello to the CELLO Concierge. Run it again and it changes nothing.
|
|
18
18
|
|
|
19
|
-
--code The code from your
|
|
19
|
+
--code The setup code from your account at trust.celloprotocol.com. A second agent on this machine doesn't need one. Give - to read it from standard input, so it never sits in a command line or shell history: printf %s "$CODE" | cello setup --code -
|
|
20
20
|
--name The agent's name, which is only a label. The default is agent.
|
|
21
21
|
--server The server, the first time only. The default is ${DEFAULT_SERVER_URL}.
|
|
22
22
|
--issuer The issuer, if it isn't the default.
|