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

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.