PostToMe gives every person or agent a personal inbox. Drop text, screenshots, links — anything — from one device or AI, pick it up from another. This page is your one-stop install guide.

1. 1

   Get an API key

   One key authenticates both sending and reading back. Open Admin and click Create key. Copy the value that appears — you can only see it once.

2. 2

   Install the CLI macOS · Linux

   One line, no dependencies. Installs posttome to /usr/local/bin.

   curl -fsSL https://posttome.app/install.sh | sh Copy

   Windows: grab a release archive from GitHub Releases. Don't have shell access? Skip ahead to step 6 — the REST API works without the CLI.

3. 3

   Save your key locally

   Writes ~/.postroom/config with 0600 perms. Replace pr_xxx with the value from step 1.

   posttome config --set-key pr_xxx Copy
4. 4

   Send your first payload

   posttome post --text "hello from $(hostname)" --event hello Copy

   Also useful: posttome post --image ./shot.png · posttome post --json @./payload.json · posttome list --limit 10 · posttome get <id>. Run posttome --help for the full reference.

5. 5

   Configure your AI agent

   A single command installs the PostToMe skill into every agent runtime on this machine. It auto-detects Cursor, Claude Code, Codex CLI, and OpenClaw / winclaw — only the ones you have installed get touched.

   curl -fsSL https://raw.githubusercontent.com/allwefantasy/posttome-skills/main/install.sh | sh Copy

   Cursor

   Drops into ~/.cursor/skills-cursor/posttome-inbox/.

   Claude Code

   Drops into ~/.claude/skills/posttome-inbox/.

   Codex CLI

   Drops into ~/.codex/skills/posttome-inbox/.

   OpenClaw / winclaw

   Drops into ~/.auto-coder/.autocoderskills/posttome-inbox/.

   Only need one of them? Pass POSTTOME_SKILLS_TARGETS="cursor" (space-separated) before sh. After install, open a new agent session and ask: "post 'hello posttome' to my inbox". The agent will pick up the skill automatically and prefer the CLI when it's on PATH.

6. 6

   No CLI? Talk to the REST API directly

   Any language with HTTP can post. Same Bearer auth, same payload shape, same backend. Great for sandboxed agents, CI, hosted notebooks.

   curl -X POST "https://posttome.app/api/ingest" \ -H "Authorization: Bearer pr_xxx" \ -H "Content-Type: application/json" \ -d '{"event":"hello","text":"hi from rest"}' Copy

   Read-back endpoints: GET /api/ingest/submissions?limit=20 and GET /api/ingest/submissions/<id>, both scoped to the calling key. Limits: text/JSON ≤ 10,000 chars, image-bearing JSON ≤ ~6 MB, 100 accepted posts per account per day.