Wordspace

A CLI for bootstrapping AI agent workspaces with ready-to-run workflows.

Workflows are .prose programs that orchestrate multi-agent systems using OpenProse, AgentWallet, and the Frames Registry.

Quick Start

npx wordspace init

This will:

Show available workflows and let you pick which ones to download
Configure agent permissions
Create the output/ directory

Then run a workflow:

npx wordspace run workflows/x-daily-pulse.prose

Wordspace auto-detects which coding agents you have installed and lets you pick one.

Supported Agents

Agent	Binary	Mode	Install
Claude Code	`claude`	interactive	`npm i -g @anthropic-ai/claude-code`
Codex	`codex`	interactive	`npm i -g @openai/codex`
Gemini CLI	`gemini`	interactive	`npm i -g @google/gemini-cli`
Aider	`aider`	headless	`pip install aider-chat`
Amp	`amp`	interactive	`npm i -g @sourcegraph/amp`
OpenCode	`opencode`	interactive	opencode.ai
Goose	`goose`	headless	`brew install block-goose-cli`
Cline	`cline`	interactive	`npm i -g cline`
Kiro	`kiro`	interactive	`curl -fsSL https://cli.kiro.dev/install \| bash`
Cursor Agent	`cursor-agent`	interactive	cursor.com
OpenClaw	`openclaw`	passthrough	`npm i -g openclaw@latest`

interactive -- hands over the terminal for live interaction
headless -- executes the prompt and exits
passthrough -- outputs workflow instructions for the calling agent (OpenClaw is already running when it invokes wordspace)

Use --harness to skip the picker:

npx wordspace run --harness aider workflows/x-daily-pulse.prose
npx wordspace run --harness claude workflows/x-daily-pulse.prose

Prerequisites

At least one supported agent installed
An AgentWallet account (for paid API workflows)
Wallet funded with USDC (even $1 covers hundreds of API calls)

Commands

`wordspace init`

Bootstrap a new project. Presents an interactive picker to choose which workflows to download.

npx wordspace init           # interactive setup
npx wordspace init --force   # re-download existing workflows

`wordspace search [query]`

Browse available workflows from the repository.

npx wordspace search          # list all
npx wordspace search pulse    # filter by keyword

`wordspace add <name>`

Download specific workflows by name.

npx wordspace add x-daily-pulse
npx wordspace add x-daily-pulse --force   # overwrite existing

`wordspace run <target>`

Run a .prose workflow via a coding agent.

npx wordspace run workflows/x-daily-pulse.prose                    # auto-detect agent
npx wordspace run --harness claude workflows/x-daily-pulse.prose   # use specific agent
npx wordspace run github:frames-engineering/wordspace/workflows/x-daily-pulse.prose  # remote

Workflows

File	Description
`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.

Running X Daily Pulse

npx wordspace run workflows/x-daily-pulse.prose

You'll be prompted for:

accounts -- X handles to monitor (e.g., elonmusk, openai)
topics -- keywords to track (e.g., AI agents, LLM tooling)
timeframe -- how far back to look (default: 24h)
goal -- your engagement goal (e.g., grow my AI agents audience)

The 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/.

Cost: ~$0.10-0.20 per run depending on the number of accounts and topics.

How It Works

                    ┌──────────────┐
                    │  .prose file │
                    └──────┬───────┘
                           │
                    ┌──────▼───────┐
                    │ OpenProse VM │  (your agent becomes the interpreter)
                    └──────┬───────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
        ┌─────▼─────┐ ┌───▼───┐ ┌─────▼─────┐
        │  Agent 1   │ │Agent 2│ │  Agent 3   │  (parallel sub-agents)
        └─────┬──────┘ └───┬───┘ └─────┬──────┘
              │            │            │
        ┌─────▼────────────▼────────────▼─────┐
        │         Frames Registry              │  (pay-per-call APIs)
        │    Twitter · Exa · AI Gen · Test     │
        └─────────────────┬────────────────────┘
                          │
                    ┌─────▼──────┐
                    │AgentWallet │  (x402 micropayments)
                    └────────────┘

OpenProse defines the workflow as a .prose program
Your coding agent becomes the VM and spawns parallel agents
Agents call external APIs through the Frames Registry
AgentWallet handles payments automatically via the x402 protocol
Results flow back through the agent pipeline into a final output

wordspace