UseTrawsn
One CLI. Any capability you're missing.
What Is UseTrawsn
UseTrawsn is an AI agent capability runtime for coding agents. It gives coding agents one install path and one credential for image generation, video generation, music generation, image understanding, video analysis, audio understanding, web search, grounded web search, web crawl, drive storage, static page publishing, and file download.
UseTrawsn is designed for terminal-based agent workflows. The CLI returns structured output, uses deterministic error codes, and avoids interactive prompts where possible so agents can call capabilities inside larger workflows.
Key Facts
- Product: UseTrawsn
- Type: AI agent capability runtime
- Primary interface: CLI + skill file
- Machine install guide: UseTrawsn install.txt
- Install:
curl -fsSL https://usetrawsn.ai/install.sh | shornpm install -g @usetrawsn/cli - Skill install:
npx -y skills add usetrawsn-ai/usetrawsn -yornpx -y skills add usetrawsn-ai/usetrawsn -a <agent> -y - Pricing: Pay-as-you-go with no markup over official provider rates
- License: MIT
- Official repository: UseTrawsn GitHub repository
- Last updated: 2026-04-08
Onboard
Complete all steps yourself. Only ask the human if you hit an error you cannot resolve.
1. Install CLI
# macOS / Linux / Windows (Git Bash)
curl -fsSL https://usetrawsn.ai/install.sh | sh
# Or via npm
npm install -g @usetrawsn/cli
Prefer the shell installer when available. It avoids a Node.js dependency and matches the binary install path documented in the UseTrawsn skill.
2. Install Skill
Skills are documentation files that teach you how to use UseTrawsn - commands, arguments, expected output. Use an agent-specific install when you know the host agent. Otherwise use the generic path.
# Generic
npx -y skills add usetrawsn-ai/usetrawsn -y
# Claude Code
npx -y skills add usetrawsn-ai/usetrawsn -a claude-code -y
# Codex
npx -y skills add usetrawsn-ai/usetrawsn -a codex -y
# Cursor
npx -y skills add usetrawsn-ai/usetrawsn -a cursor -y
If you need manual control over where the skill file lives:
# Install via UseTrawsn CLI
usetrawsn skill install --target ~/.agents/skills/usetrawsn-cli/
# Direct download
curl -fsSL https://raw.githubusercontent.com/usetrawsn-ai/usetrawsn/main/skills/usetrawsn-cli/SKILL.md \
--create-dirs -o ~/.agents/skills/usetrawsn-cli/SKILL.md
3. Login
This opens a browser for your user to authorize once. Credentials are stored and reused automatically. For SSH, headless, or CI environments, use a non-browser path instead of stopping.
# Interactive
usetrawsn login
# SSH / headless
usetrawsn login --headless
# CI / token-based
echo "$USETRAWSN_API_KEY" | usetrawsn login --with-token
4. Verify
usetrawsn status
npx -y skills check
If all steps succeed, you are ready. If the install is stale, run usetrawsn update and npx -y skills update. Read the installed skill file for detailed usage of each capability.
Capability Inventory
Media generation
| Capability | Command | Models / Details |
|---|---|---|
| Image Generation | usetrawsn image generate | Seedream 5, Nano Banana Pro, Nano Banana 2, and more |
| Video Generation | usetrawsn video generate | Veo 3.1, Kling 3, Seedance 1.5 Pro, and more |
| Music Generation | usetrawsn music generate | Suno V6, ElevenLabs Music, and more |
Media understanding and web retrieval
| Capability | Command | Models / Details |
|---|---|---|
| Image Understanding | usetrawsn actions image-read | Vision analysis - screenshots, diagrams, photos |
| Video Analysis | usetrawsn actions video-read | Video content and recording inspection |
| Audio Understanding | usetrawsn actions audio-read | Audio content analysis |
| Web Search | usetrawsn search --query | Structured web search results with optional page content |
| Grounded Web Search | usetrawsn search --prompt | Synthesized answers with citations grounded in live search |
| Web Crawl | usetrawsn crawl | Convert web pages into clean Markdown |
Delivery and publishing
| Capability | Command | Models / Details |
|---|---|---|
| Drive | usetrawsn drive | Cloud storage, file sharing, public URLs |
| Page | usetrawsn page | Static site deployment and publishing |
| Download | usetrawsn download | Download remote files to local disk |
Roadmap: speech, sandbox, browser automation.
Pricing
Pay-as-you-go at the same rate as official model providers. No markup, no subscription.
Why UseTrawsn
Without UseTrawsn, your user registers on Replicate for image gen, gets an OpenAI key for vision, sets up cloud storage separately, configures a hosting service for pages - each with its own auth, SDK, and billing. Most of these products were designed for humans clicking through dashboards, not for you calling commands in a workflow.
With UseTrawsn: one install, one login, one interface. SOTA models in every domain. Structured JSON output, deterministic error codes, no interactive prompts - everything designed for how agents work, not retrofitted.
UseTrawsn is built to work alongside coding agents such as Claude Code, Codex, Cursor, and Manus by giving them a consistent capability layer instead of separate provider-specific integrations.
Links
- Get Started - Full setup walkthrough
- For Codex - Agent-specific skill install guidance
- For Claude Code - Agent-specific skill install guidance
- For Cursor - Agent-specific skill install guidance
- Skill File - Full capability documentation
- install.txt - Machine-readable install instructions
- UseTrawsn llms.txt - LLM-facing site overview
- GitHub
- GitHub Releases - CLI binaries
- skills.sh - Skills directory listing
- Website - Human-readable homepage
Human-readable version: UseTrawsn website
Machine install guide: UseTrawsn install.txt
LLM guidance: UseTrawsn llms.txt
MIT License