Wribble

Minimal thoughts blog — write posts, organize into channels, and publish from your terminal or AI agent.

Wribble is a minimal writing tool for publishing short-form thoughts. Posts are organized into channels — shared feeds that can be browsed publicly. Everything is controllable via CLI or MCP.

Key concepts:

Post — a piece of writing, supports multiple language versions in a single post object
Channel — a named collection of posts; channels are shared and browsable

Install

npm install -g wribble

Authenticate

Generate a token at app.wribble.iopho.com → Settings → Integrations → CLI Token, then:

wribble auth token rdk_your_token_here

Verify:

wribble auth status

CLI reference

Posts

# Publish a new post
wribble post "Your thought here"
wribble post --file draft.md --lang en --channel ideas
echo "piped content" | wribble post --title "My Title"

# List posts
wribble posts list
wribble posts list --channel <slug>      # Filter by channel
wribble posts list --limit 20 --offset 0

# Read a post
wribble posts get <id>                   # Full post with all language versions

# Edit a post
wribble posts edit <id> --content "Updated text" --lang en
wribble posts edit <id> --title "New title"

# Delete a post
wribble posts delete <id>
wribble posts delete <id> --force        # Skip confirmation

Channels

wribble channels list                    # List all channels
wribble channels get <id>                # Get channel details + post count
wribble channels create                  # Create channel (interactive)
wribble channels update <id>             # Update channel name/description
wribble channels delete <id>
wribble posts assign <post-id> <channel-id>   # Assign post to channel

Search

wribble search <query>                   # Full-text search across your posts
wribble search <query> --json            # JSON output for scripting

Global flags

Flag	Description
`--json`	JSON output (pipe-friendly)
`--no-color`	Disable color for CI/scripts

MCP server

Add to your MCP client config (e.g. ~/.claude/settings.json):

{
  "mcpServers": {
    "wribble": {
      "command": "npx",
      "args": ["-y", "wribble", "mcp"],
      "env": {
        "WRIBBLE_TOKEN": "rdk_your_token_here"
      }
    }
  }
}

MCP tools reference

Posts (8 tools)

Tool	Description
`wribble_list_posts`	List posts, optionally filtered by channel. Pass `"no-channel"` to get unassigned posts.
`wribble_get_post`	Get full post content including all language versions
`wribble_create_post`	Create a new post with title and content
`wribble_update_post`	Update an existing post (title, content, language version)
`wribble_delete_post`	Soft-delete a post
`wribble_search_posts`	Full-text search across posts
`wribble_get_post_channels`	List channels a post belongs to
`wribble_assign_channels`	Assign a post to one or more channels

Channels (5 tools)

Tool	Description
`wribble_list_channels`	List all channels with post counts
`wribble_get_channel`	Get channel details
`wribble_create_channel`	Create a new channel
`wribble_update_channel`	Update channel name or description
`wribble_delete_channel`	Delete a channel

Install agent skill

npx skills add iopho-team/iopho-skills --skill wribble

→ PAT Tokens for non-interactive setup