clarkbrain

CLI to provision your ClarkBrain — a personal AI second-brain assistant that lives in Slack, backed by your own isolated Fly Machine running an autonomous agent with sandbox + web tools.

Get an invite

ClarkBrain is invite-only while I scale infrastructure thoughtfully. Request one via the waitlist form or email me at [email protected].

Install

npm i -g clarkbrain

Requires Node 20+. The CLI bundles all its deps except @napi-rs/keyring (used for OS keychain access).

Quickstart (you have an invite)

You'll have received a cbi_… invite token from your operator.

export CLARKBRAIN_INSTALL_TOKEN=cbi_xxxxxxxxxxxxxxxxxxxxx
clarkbrain setup

The setup walks you through:

1. Creating a Slack app from a pre-configured manifest (one click)
2. Pasting an xapp-… app-level token + an xoxb-… bot token
3. Entering the email you use in Slack

No API keys to bring — the model runs on the operator's account. Total time: ~2 minutes. After that, DM your bot in Slack or run clarkbrain ask "..." from your terminal.

Use it from Claude Code

If you use Claude Code, drop the ClarkBrain skill into your config so you can invoke it with /clarkbrain or just say "ask my second brain":

clarkbrain skill install

That writes a SKILL.md to ~/.claude/skills/clarkbrain/. Claude Code picks up new skills live — no restart needed. Use --scope project to install to the current project's .claude/skills/ instead.

Commands

clarkbrain setup                      Provision your ClarkBrain (Slack)
clarkbrain ask "<msg>" [-f file]      Send a message; -f attaches a file (any size up to 50 MB)
clarkbrain upload <path> [--as name]  Push a file into your persistent volume
clarkbrain download <name> [-o out]   Pull a file back
clarkbrain ls                         List files in your volume
clarkbrain rm <name>                  Delete a file from your volume
clarkbrain logs                       Tail your machine's logs (needs flyctl)
clarkbrain teardown                   Destroy your machine + volume
clarkbrain doctor                     Check router connectivity
clarkbrain auth login|logout|status   Manage your local credentials
clarkbrain skill install              Drop the SKILL.md into ~/.claude/skills/
clarkbrain --help                     See all commands

ask -f inlines text/markdown up to 80 KB in the prompt; larger files and binaries auto-upload to your persistent volume, and the agent reads them from a sandbox when it needs to. Use the explicit upload/ls/ download/rm commands when you want a file to stick around for the agent to access across sessions.

Where credentials live

The CLI stores your cbk_… chat token in your OS keychain (macOS Keychain / libsecret on Linux / Credential Manager on Windows) via @napi-rs/keyring. If the keychain is unavailable, it falls back to a chmod 0600 file under your platform's config dir (env-paths).

clarkbrain auth status shows where your token is.

Issues

Bug reports / feature requests: [email protected].