wordspace
1.032 instalações · frames-engineering/wordspace
Open source Repository Open in the app JSON README (API)
About
Skill publicada por frames-engineering/wordspace, com 1.032 instalações medidas pelo skills.sh. Instale com: npx skills add frames-engineering/wordspace@wordspace
Details
- Kind
- Agent skills
- Topic
- No topic detected
- Publisher
- frames-engineering
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 2
- Forks
- 1
- Last push
- 2026-02-19T04:11:19Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-30 15:22:51
- Updated
- 2026-08-30 15:22:51
- Origin id
frames-engineering/wordspace/wordspace
README
# Wordspace
A CLI for bootstrapping AI agent workspaces with ready-to-run workflows.
Workflows 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).
## Quick Start
```bash
npx wordspace init
```
This will:
1. Show available workflows and let you pick which ones to download
2. Configure agent permissions
3. Create the `output/` directory
Then run a workflow:
```bash
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](https://claude.ai/code) | `claude` | interactive | `npm i -g @anthropic-ai/claude-code` |
| [Codex](https://github.com/openai/codex) | `codex` | interactive | `npm i -g @openai/codex` |
| [Gemini CLI](https://github.com/google/gemini-cli) | `gemini` | interactive | `npm i -g @google/gemini-cli` |
| [Aider](https://aider.chat) | `aider` | headless | `pip install aider-chat` |
| [Amp](https://sourcegraph.com/amp) | `amp` | interactive | `npm i -g @sourcegraph/amp` |
| [OpenCode](https://opencode.ai) | `opencode` | interactive | [opencode.ai](https://opencode.ai) |
| [Goose](https://block.github.io/goose) | `goose` | headless | `brew install block-goose-cli` |
| [Cline](https://cline.bot) | `cline` | interactive | `npm i -g cline` |
| [Kiro](https://kiro.dev) | `kiro` | interactive | `curl -fsSL https://cli.kiro.dev/install \| bash` |
| [Cursor Agent](https://cursor.com) | `cursor-agent` | interactive | [cursor.com](https://cursor.com) |
| [OpenClaw](https://openclaw.ai) | `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:
```bash
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](#supported-agents) installed
- An [AgentWallet](https://frames.ag) 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.
```bash
npx wordspace init # interactive setup
npx wordspace init --force # re-download existing workflows
```
### `wordspace search [query]`
Browse available workflows from the repository.
```bash
npx wordspace search # list all
npx wordspace search pulse # filter by keyword
```
### `wordspace add <name>`
Download specific workflows by name.
```bash
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.
```bash
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`](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. |
### Running X Daily Pulse
```bash
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)
└────────────┘
```
1. **OpenProse** defines the workflow as a `.prose` program
2. **Your coding agent** becomes the VM and spawns parallel agents
3. **Agents** call external APIs through the **Frames Registry**
4. **AgentWallet** handles payments automatically via the x402 protocol
5. Results flow back through the agent pipeline into a final output
## Links
- [OpenProse](https://github.com/openprose/prose) -- the programming language for AI sessions
- [AgentWallet](https://frames.ag) -- wallets for AI agents
- [Frames Registry](https://registry.mcpay.tech) -- pay-per-call API gateway
- [x402 Protocol](https://www.x402.org/) -- HTTP payment standard