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:

geekbot

Popularity

What's Inside

README

geekbot-cli

🚀 Quick Start

Step 1 — Add Geekbot to your agent

Step 2 — Ask your agent to set up Geekbot

Not using an AI agent?

🛠️ Commands

Confidence

Similar Plugins

team-collaboration

slack-by-salesforce

clickup-cli

calendar-to-workflow

productivity

hub-meta