arena-claw
v2.2.0Simple CLI wrapper for the are.na API. Lists channels, adds blocks, watches feeds. No AI, no automation, no external integrations. Just API calls.
Installation
Please help me install the skill `arena-claw` from SkillHub official store.
npx skills add koellins/arena-claw
are.na-claw
Simple, transparent CLI for are.na API. No AI. No automation. No hidden features.
What This Does
- Makes API calls to are.na
- Lists channels and blocks
- Adds images/links to channels
- Watches channels for changes
- Switches between multiple accounts
What This Does NOT Do
- ✗ AI-powered curation
- ✗ Automatic content discovery
- ✗ Cross-platform sync
- ✗ External integrations
- ✗ Image analysis or color extraction
- ✗ Scheduled automation
Installation
# Clone the repository
git clone https://github.com/yourusername/arena-claw ~/arena-claw
# Or copy just the arena script
cp arena-claw/arena ~/bin/arena
chmod +x ~/bin/arena
# Add to PATH (add to ~/.zshrc or ~/.bashrc)
export PATH="$HOME/bin:$PATH"
Source Code
The CLI is a single Python script: arena
It uses only:
- curl for API calls
- python3 for parsing
- Local files for token storage
No dependencies, no external imports.
Authentication
Your API token stays on your machine.
Tokens are stored locally:
- Single account: ~/.arena_token
- Multi-account: ~/.openclaw/.arena_tokens
The skill never sends your tokens anywhere except to are.na API.
# Add your account
arena auth YOUR_API_TOKEN
# Or add named account
arena auth YOUR_API_TOKEN myaccount
# Switch accounts
arena switch myaccount
# List accounts
arena accounts
Usage
# Check your account
arena me
# List your channels
arena channels
# Get channel contents
arena channel channel-name
# Add image to channel
arena add image https://example.com/image.jpg --channel my-channel
# Add link to channel
arena add link https://example.com --channel my-channel --title "Example"
# Watch for new items
arena watch channel-name --interval 60
# Search channels
arena search glitch
# Create channel
arena create "my-channel"
Multi-Account
# Add multiple accounts
arena auth TOKEN1 account1
arena auth TOKEN2 account2
# Use specific account
arena -a account1 me
arena -a account2 channel shared-channel
# Switch default account
arena switch account1
Commands
| Command | Description |
|---|---|
arena auth <token> [name] |
Add API token |
arena accounts |
List configured accounts |
arena switch <name> |
Switch default account |
arena me |
Show current user |
arena channels [user] |
List channels |
arena channel <slug> |
Get channel contents |
arena add <type> <url> --channel <name> |
Add block to channel |
arena watch <slug> |
Watch for changes |
arena search <query> |
Search channels |
arena create <title> |
Create new channel |
arena trending |
Search trending |
arena explore <keywords> |
Search by keywords |
arena analyze <slug> |
Count block types |
arena doctor |
Debug connection |
Security
- No credential harvesting - Tokens stored only in your home directory
- No external calls - Only talks to api.are.na
- No data exfiltration - All data stays local
- No automatic execution - Every command is explicit
- No dependencies - Only curl and shell built-ins
Uninstall
rm -rf ~/arena-claw
rm ~/.arena_token ~/.openclaw/.arena_tokens
No Warranty
This is a simple wrapper. Use at your own risk. Always verify what commands do before running them.