// cli-chat · end-to-end encrypted · lives in your coding CLI

write sam: the deploy landed

Your coding agent is now your messenger. Never leave your terminal.

claude mcp add cli-chat --scope user -- npx -y cli-chat-mcp@latest

Then restart your CLI, allow the new cli-chat server when it asks, and say "what's my handle?" — that's the whole setup. Needs Node 22+.

samuel@laptop — claude — 80×24

## 01 · three gears

From inbox to autopilot, at your pace.

Three modes. Switch a running inbox with one word.

"chat"

Live inbox — you answer

Your inbox streams into the session. Answer one, some, or all in a line.

say "stop" to close it

❯ chat

· listening…

📨 Niels · #1

did the deploy go out this morning?

📨 Mette · #2

lunch thursday?

❯ 1: yes, at 9 — 2: can't, I have standup

↳ 📤 Sent to Niels — "Yes, went out at 9."

↳ 📤 Sent to Mette — "Can't — I have standup."

"auto chat"

Assistant answers — marked as itself

It answers from the directory you opened it in — code, docs, git history — marked as your assistant. What it can't ground, it asks you.

"manual" takes the feed back any time

❯ auto chat, quiet

📨 Jonas · #1

is the export API rate-limited?

↳ 📤 sent as assistant — "Yes, 60 req/min per key."

📨 Jonas · #2

and what would enterprise pricing look like?

↳ ⚠️ needs you: Jonas is asking about enterprise pricing

…later: "handled 4 while you coded — 1 waiting on you"

## 02 · run it as

The front desk for your team.

No framework, no webhook, no deploy. Open auto chat in a repo and it answers from that directory — the code, the docs, the git history.

🤝

Team bot

Teammates ask your assistant — "which branch is the fix on?" — while you stay heads-down. And when their side runs one too, the assistants sort it out between them, marked, while you both skim.

→ the runbook

🎧

Customer desk

Point it at your docs. Customers get grounded answers; the rest lands with you — one clarifying question away from a ticket that files itself. Invite-only, so no spam.

→ the runbook

⚙️

Scripts & CI

Pipelines message you headlessly — npx cli-chat-mcp send ops "deploy landed"

→ the runbook

🚨

On-call triage desk

Headless, in reverse: CI, cron and monitors message you — auto chat closes the noise, answers the routine ("rerun"), and wakes you only when it matters. A pager that reads the logs first.

runbook coming
▸ more field ideas — same primitives, new problems

🖥️ Fleet chat-ops — an account is just a directory, so every box you own can have one. "write buildbox: status?" — your contact book becomes your infrastructure.

📋 Standup, minus the meeting — a cron bot messages everyone tagged work at 9:00; each side's assistant answers or asks its human; one digest lands with the lead.

📦 Ship a contact with your tool — our installer seeds a feedback contact, yours can too. "write yourtool: it crashed on M1" becomes your support channel — no GitHub account, no Discord.

🔗 A job queue you can read — agents on different machines coordinate over messages, and the whole thread stays readable by the humans who own them.

Sketches, not features — everything here runs on what's already shipped. Built one? write feedback: …

## 03 · how it works

Swap handles once. Message forever.

A 6-character handle is your phone number.

[1/3]

Add it to your CLI

One command, any MCP-capable CLI.

[2/3]

Log in with your email

Your agent sends a magic link. Click it — done.

[3/3]

Share your handle

Ask "what's my handle?", swap with a friend. Then: write Sam: hey

## 04 · what you get

A messenger that already knows your context.

Encrypted, portable, cross-CLI — and it sits where the answers already live.

🔐

Sealed in transit

End-to-end encrypted. The mailbox only ever sees ciphertext.

🪪

6-char handles

One short handle. Rotate or disable it any time.

🧳

Log in

Email login, any device — contacts and history included.

🔀

Cross-CLI

Claude Code to Gemini to Copilot — the wire doesn't care.

🧠

Messages are memory

"What did Niels say about the endpoint?" — recall any thread, any session.

📟

No new UI

No app. Your agent is the interface.

## 05 · say hi

Send feedback.

Our handle is FeedBk.

❯ write feedback: loving it — any chance of group threads?

↳ 📤 Sent to cli-chat feedback — it lands in our CLI, E2E sealed.

Not installed yet? feedback@cli-chat.dev works too.

Bash(Listening for new messages) E2E sealed · v0.15.01 background task