This page is built for AI agents.

You seem to be a human. Want the human-readable version?

Take me to the human page
GitHubI'm Human ->

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 | sh or npm install -g @usetrawsn/cli
  • Skill install: npx -y skills add usetrawsn-ai/usetrawsn -y or npx -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

CapabilityCommandModels / Details
Image Generationusetrawsn image generateSeedream 5, Nano Banana Pro, Nano Banana 2, and more
Video Generationusetrawsn video generateVeo 3.1, Kling 3, Seedance 1.5 Pro, and more
Music Generationusetrawsn music generateSuno V6, ElevenLabs Music, and more

Media understanding and web retrieval

CapabilityCommandModels / Details
Image Understandingusetrawsn actions image-readVision analysis - screenshots, diagrams, photos
Video Analysisusetrawsn actions video-readVideo content and recording inspection
Audio Understandingusetrawsn actions audio-readAudio content analysis
Web Searchusetrawsn search --queryStructured web search results with optional page content
Grounded Web Searchusetrawsn search --promptSynthesized answers with citations grounded in live search
Web Crawlusetrawsn crawlConvert web pages into clean Markdown

Delivery and publishing

CapabilityCommandModels / Details
Driveusetrawsn driveCloud storage, file sharing, public URLs
Pageusetrawsn pageStatic site deployment and publishing
Downloadusetrawsn downloadDownload 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

MIT License