geekbot-cli
Geekbot runs asynchronous standups, check-ins, and polls in Slack and Microsoft Teams. This CLI lets you run them straight from your AI coding agent — or the terminal.
Every command returns structured JSON with machine-readable exit codes, credentials live in your OS keychain (never in dotfiles), and it works wherever your agent does — Claude Code, Claude Desktop, Codex CLI, Gemini CLI, and any Agent Skills tool (Cursor, Windsurf, Copilot, …).
🚀 Quick Start
Two steps, then you're talking to Geekbot in plain English.
Step 1 — Add Geekbot to your agent
Pick your tool:
Claude Code
# Inside Claude Code:
/plugin marketplace add geekbot-com/geekbot-cli
/plugin install geekbot@geekbot-cli
/reload-plugins
Claude Desktop
- Settings → Extensions → Install from GitHub… and enter
geekbot-com/geekbot-cli, then restart when prompted.
- Allowlist the API domain. Claude Desktop sandboxes network access, so add
api.geekbot.com under Settings → Sandbox → Allowed domains and apply it to all conversations. (Org admins must also allow it in the Anthropic console.)
Skills only run in surfaces that support tools — today that's cowork sessions and code chats, not regular text chats.
Codex CLI
# Register the marketplace (shell):
codex plugin marketplace add geekbot-com/geekbot-cli
Then start codex, open /plugins, find geekbot under the geekbot-cli marketplace, and install it.
Gemini CLI
gemini extensions new geekbot --from geekbot-com/geekbot-cli
Cursor, Windsurf, Copilot & 60+ other agents
These tools don't use plugins — they support the open Agent Skills convention (a SKILL.md file the agent auto-discovers). Install the Geekbot skill into all of them at once with Vercel Skills, which detects your installed agents and copies (or symlinks) the skill into each one's skills/ directory:
npx skills add geekbot-com/geekbot-cli
This covers Cursor, Windsurf, GitHub Copilot, Cline, Roo Code, Zed, and dozens more.
Step 2 — Ask your agent to set up Geekbot
Just say it in plain English:
"Set up Geekbot."
Your agent will:
- Install the
geekbot CLI (npm install -g geekbot-cli) if it isn't already on your $PATH.
- Log you in — browser-based OAuth, no API key to paste. The token is stored securely in your OS keychain.
- Verify everything and report back.
That's it. Now just ask for what you want:
"Fetch my standups."
"Draft my standup report for today."
"Who hasn't posted in the daily standup?"
"Create a poll asking the team where to go for lunch."
Not using an AI agent?
You can drive the CLI directly. See Manual installation below.
npm install -g geekbot-cli # install
geekbot auth login # browser OAuth (or: geekbot auth setup --api-key <KEY>)
geekbot standup list # structured JSON on stdout
🛠️ Commands
The CLI follows a geekbot <resource> <action> [options] pattern. Run geekbot <resource> <action> --help for the full option list on any command. It wraps the Geekbot API — see developers.geekbot.com for the underlying endpoints and full data shapes.
| Resource | Actions | What it does |
|---|
standup | list · get <id> · create · start <id> | List, inspect, create, or immediately trigger standups |
report | list · get <id> · create · edit <id> · delete <id> | Read and submit standup reports |
poll | list · get <id> · create · votes <id> | Manage polls and read results (Slack teams only) |
me | show · teams | Show your profile or the teams you belong to |
team | list | List teams with their members |
auth | login · setup · status · remove | Manage authentication (see below) |
A few common examples:
