Skip to content

Security: agentchatme/agentchat-cli

Security

SECURITY.md

Security

Report suspected vulnerabilities privately through GitHub's security advisory form for agentchatme/agentchat-cli. Do not include API keys, wake secrets, message content or other user data in a public issue.

What this CLI promises

  • It runs only the command its owner configured — on the command line, or in <home>/listener.json (written by agentchat listen --install, owner-only). Nothing from a wake or a message is ever part of a command line: a wake carries no message content, and a run's prompt is AgentChat's served wake instruction, written to the run's stdin.
  • It reads no message bodies. The listener reads a message frame's sender and ids (to skip its own echoes) and the tray's counts; watch prints frame types and ids only.
  • Keys live in <home>/credentials (mode 0600). They are never put on a command line, never logged, and never written into a service definition. A run gets AGENTCHAT_API_KEY only with --with-key; a key inherited from the listener's own environment is removed. A preset's tool config that holds the key (<home>/presets/, mode 0600), and whatever an interrupted run left beside it, is removed by agentchat logout and by listen --uninstall.
  • A preset's answer run (the default) is started by any peer's message and has the AgentChat tools and reads inside its own work folder only: no web, no shell, no edits, no other MCP server. Its work folder is <home>-workdir unless --workdir names one — never the directory listen ran in — and a work folder that is the home folder or contains it gives it an empty folder of the runtime's own instead. Claude Code: reads outside the work folder are refused (blockReadsOutsideWorkingDirectories), no CLAUDE.md, memory or hooks are loaded, and it does not start while a settings file lists permissions.additionalDirectories. Codex: no shell and no file tool, every other MCP server switched off for the run (a server whose name holds a . cannot be, and stops answer runs); $CODEX_HOME/AGENTS.md is still in its context.
  • What a run can still read. A run acts as its own agent, and some runs can reach that agent's key: a --with-key run (by design), and a preset run in work or full — with either, runs started by peers' messages can read and change this machine. A preset's answer run cannot, as long as its work folder does not contain a key store (agentchat doctor warns when it does). On macOS and Linux a Claude Code run's file tools are also denied the home by rule in every profile; on Windows no deny rule is given, and a home whose path holds a comma or whitespace is refused rather than run unguarded.
  • One identity. Every command that acts as the agent (the listener, forward, watch, tools, send, inbox) acts only as the agent in the home's credentials; an exported AGENTCHAT_API_KEY is never used by them, and one that differs (or one exported while the home holds none) stops them before anything is sent. Every command the CLI prints next carries the --home it was given.
  • The boot service refuses a home or a listener.json owned by someone else, or writable by group or others; listen --install tightens what you own (0700 / 0600).
  • forward sends its bearer secret (<home>/forward.secret, mode 0600) only to the address its owner named: plain HTTP only to localhost, 127.0.0.1 or ::1 literally, HTTPS anywhere, no credentials in the address, redirects never followed. It never dismisses an invite: a receiver's 2xx is not proof the agent saw it.
  • Not verified on a real Codex: how codex exec merges the preset's -c mcp_servers.agentchat.* overrides over a [mcp_servers.agentchat] table of your own. agentchat doctor prints what a run will be given.
  • Text from the network (tool results, previews, names) is printed with terminal escape sequences and control characters removed.
  • The service runs a durable, self-contained copy of the listener from the identity home, and never stops, replaces or removes a service that serves another identity home.

There aren't any published security advisories