grok-bot-skill

KO | EN

gitlite — search

#containers #ui #go #postgresql #terminal #git #llm #privacy #python #generative-ai

(★ 9)

Cursor / Agent Skill to chat with Grok Bot teammates and create new Grok Bots from the CLI

File Explorer

ZIP Download

- marketplace.json
- grokbot.py
.gitignore
AGENTS.md
CHANGELOG.md
examples.md
LICENSE
package.json
README.md
SECURITY.md
SKILL.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

# Project Badges

License: MIT Visit
Agent Skill Visit
skills.sh Visit
Install Visit

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Cursor / Claude Code / Codex skill** to chat with [Grok Bot](https://grok.com) teammates and create new Grok Bots from the terminal — without clicking through the desktop UI.

This is the xAI **Grok Bot** desktop app (cloud computer + named teammates). It is **not** the Cursor Cloud Agents API (`api.cursor.com/v1/agents`).

## Install

```bash
npx skills add adamanz/grok-bot-skill -g -a cursor
```

Works with other agents too:

```bash
npx skills add adamanz/grok-bot-skill -g -a claude-code
npx skills add adamanz/grok-bot-skill -g -a codex
npx skills add adamanz/grok-bot-skill --all
```

Or clone it yourself:

```bash
git clone https://github.com/adamanz/grok-bot-skill.git ~/.cursor/skills/grok-bot
```

Then ask Cursor: **“list my Grok Bots”** or **“message Reed”**.

## Requirements

- macOS with the **Grok Bot** desktop app installed and signed in
- An eligible plan (SuperGrok Heavy, Cursor Ultra, or Cursor Teams Premium)
- Python 3 (stdlib only — no pip packages)

The CLI uses your local Grok Bot session. It never prints tokens, gateway URLs, or Keychain material.

## What you can do

| Command | Purpose |
|---|---|
| `status` | Sign-in + cloud computer health |
| `list` | List Grok Bot teammates |
| `chat` | Send a prompt and wait for a reply |
| `send` | Fire-and-forget a prompt |
| `create` | Spin up a new named Grok Bot |
| `update` | Edit name, title, or standing rules |
| `transcript` | Read recent conversation |

```bash
SCRIPT="$HOME/.cursor/skills/grok-bot/scripts/grokbot.py"

python3 "$SCRIPT" status
python3 "$SCRIPT" list
python3 "$SCRIPT" chat --name Reed --prompt "What are you waiting on from me?"
python3 "$SCRIPT" create --name Reed --title "Chief of staff" \
  --description "Draft-only daily brief. Never send messages."
```

See [examples.md](examples.md) for more prompts and [SKILL.md](SKILL.md) for agent instructions.

## Why this exists

Grok Bot teammates live on a shared cloud computer. The official path is the desktop app. This skill lets your coding agent:

- message an existing bot and bring the reply back into chat
- create a focused teammate (one job, standing rules, draft-only first task)
- stay out of the Cursor Cloud Agents API when you asked for a Grok Bot

## Safety

- Do not paste passwords, API keys, or 2FA into prompts. Take over **Agent Computer** in the Grok Bot app instead.
- Separate bots are not a security boundary — they share one computer.
- The CLI decrypts the local session only to call the API. Treat `sand-secrets.json` and Keychain as secrets.

## Discover

- [skills.sh/adamanz/grok-bot-skill](https://skills.sh/adamanz/grok-bot-skill)
- Search GitHub: `grok-bot skill`, `cursor grok bot`, `xai grok teammates`
- Agent Skills spec: [agentskills.io](https://agentskills.io)

## License

MIT

grok-bot-skill

File Explorer

# Use via CDN

# Project Badges

Was this content helpful?

Recent Feedback

Download README