{
  "markdown": "# Wordspace\n\nA CLI for bootstrapping AI agent workspaces with ready-to-run workflows.\n\nWorkflows are `.prose` programs that orchestrate multi-agent systems using [OpenProse](https://github.com/openprose/prose), [AgentWallet](https://frames.ag), and the [Frames Registry](https://registry.mcpay.tech).\n\n## Quick Start\n\n```bash\nnpx wordspace init\n```\n\nThis will:\n\n1. Show available workflows and let you pick which ones to download\n2. Configure agent permissions\n3. Create the `output/` directory\n\nThen run a workflow:\n\n```bash\nnpx wordspace run workflows/x-daily-pulse.prose\n```\n\nWordspace auto-detects which coding agents you have installed and lets you pick one.\n\n## Supported Agents\n\n| Agent | Binary | Mode | Install |\n|-------|--------|------|---------|\n| [Claude Code](https://claude.ai/code) | `claude` | interactive | `npm i -g @anthropic-ai/claude-code` |\n| [Codex](https://github.com/openai/codex) | `codex` | interactive | `npm i -g @openai/codex` |\n| [Gemini CLI](https://github.com/google/gemini-cli) | `gemini` | interactive | `npm i -g @google/gemini-cli` |\n| [Aider](https://aider.chat) | `aider` | headless | `pip install aider-chat` |\n| [Amp](https://sourcegraph.com/amp) | `amp` | interactive | `npm i -g @sourcegraph/amp` |\n| [OpenCode](https://opencode.ai) | `opencode` | interactive | [opencode.ai](https://opencode.ai) |\n| [Goose](https://block.github.io/goose) | `goose` | headless | `brew install block-goose-cli` |\n| [Cline](https://cline.bot) | `cline` | interactive | `npm i -g cline` |\n| [Kiro](https://kiro.dev) | `kiro` | interactive | `curl -fsSL https://cli.kiro.dev/install \\| bash` |\n| [Cursor Agent](https://cursor.com) | `cursor-agent` | interactive | [cursor.com](https://cursor.com) |\n| [OpenClaw](https://openclaw.ai) | `openclaw` | passthrough | `npm i -g openclaw@latest` |\n\n**interactive** -- hands over the terminal for live interaction\n**headless** -- executes the prompt and exits\n**passthrough** -- outputs workflow instructions for the calling agent (OpenClaw is already running when it invokes wordspace)\n\nUse `--harness` to skip the picker:\n\n```bash\nnpx wordspace run --harness aider workflows/x-daily-pulse.prose\nnpx wordspace run --harness claude workflows/x-daily-pulse.prose\n```\n\n## Prerequisites\n\n- At least one [supported agent](#supported-agents) installed\n- An [AgentWallet](https://frames.ag) account (for paid API workflows)\n- Wallet funded with USDC (even $1 covers hundreds of API calls)\n\n## Commands\n\n### `wordspace init`\n\nBootstrap a new project. Presents an interactive picker to choose which workflows to download.\n\n```bash\nnpx wordspace init           # interactive setup\nnpx wordspace init --force   # re-download existing workflows\n```\n\n### `wordspace search [query]`\n\nBrowse available workflows from the repository.\n\n```bash\nnpx wordspace search          # list all\nnpx wordspace search pulse    # filter by keyword\n```\n\n### `wordspace add <name>`\n\nDownload specific workflows by name.\n\n```bash\nnpx wordspace add x-daily-pulse\nnpx wordspace add x-daily-pulse --force   # overwrite existing\n```\n\n### `wordspace run <target>`\n\nRun a `.prose` workflow via a coding agent.\n\n```bash\nnpx wordspace run workflows/x-daily-pulse.prose                    # auto-detect agent\nnpx wordspace run --harness claude workflows/x-daily-pulse.prose   # use specific agent\nnpx wordspace run github:frames-engineering/wordspace/workflows/x-daily-pulse.prose  # remote\n```\n\n## Workflows\n\n| File | Description |\n|------|-------------|\n| [`x-daily-pulse.prose`](workflows/x-daily-pulse.prose) | Multi-agent Twitter/X intelligence briefing. Fetches real tweet data via paid API calls, analyzes engagement, and produces a daily digest with draft replies. |\n\n### Running X Daily Pulse\n\n```bash\nnpx wordspace run workflows/x-daily-pulse.prose\n```\n\nYou'll be prompted for:\n- **accounts** -- X handles to monitor (e.g., `elonmusk, openai`)\n- **topics** -- keywords to track (e.g., `AI agents, LLM tooling`)\n- **timeframe** -- how far back to look (default: `24h`)\n- **goal** -- your engagement goal (e.g., `grow my AI agents audience`)\n\nThe workflow spawns four specialized agents (data-fetcher, analyst, engagement-coach, briefing-writer) that fetch live Twitter data, analyze engagement patterns, and produce a markdown briefing saved to `./output/`.\n\n**Cost:** ~$0.10-0.20 per run depending on the number of accounts and topics.\n\n## How It Works\n\n```\n                    ┌──────────────┐\n                    │  .prose file │\n                    └──────┬───────┘\n                           │\n                    ┌──────▼───────┐\n                    │ OpenProse VM │  (your agent becomes the interpreter)\n                    └──────┬───────┘\n                           │\n              ┌────────────┼────────────┐\n              │            │            │\n        ┌─────▼─────┐ ┌───▼───┐ ┌─────▼─────┐\n        │  Agent 1   │ │Agent 2│ │  Agent 3   │  (parallel sub-agents)\n        └─────┬──────┘ └───┬───┘ └─────┬──────┘\n              │            │            │\n        ┌─────▼────────────▼────────────▼─────┐\n        │         Frames Registry              │  (pay-per-call APIs)\n        │    Twitter · Exa · AI Gen · Test     │\n        └─────────────────┬────────────────────┘\n                          │\n                    ┌─────▼──────┐\n                    │AgentWallet │  (x402 micropayments)\n                    └────────────┘\n```\n\n1. **OpenProse** defines the workflow as a `.prose` program\n2. **Your coding agent** becomes the VM and spawns parallel agents\n3. **Agents** call external APIs through the **Frames Registry**\n4. **AgentWallet** handles payments automatically via the x402 protocol\n5. Results flow back through the agent pipeline into a final output\n\n## Links\n\n- [OpenProse](https://github.com/openprose/prose) -- the programming language for AI sessions\n- [AgentWallet](https://frames.ag) -- wallets for AI agents\n- [Frames Registry](https://registry.mcpay.tech) -- pay-per-call API gateway\n- [x402 Protocol](https://www.x402.org/) -- HTTP payment standard\n",
  "bytes": 6018,
  "sha": "84fbcbe92fde06672605aa33420b7eac43e7dfb2f78df2932577f86541ab69df",
  "repo_slug": "frames-engineering/wordspace",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_frames_engineering_wordspace_wordspace_bf7d8788/readme"
}