Tsunami Code

Agentic developer CLI powered by free AI models. No API keys. No setup. Just code.

npm install -g tsunami-code
tsunami

What It Does

Tsunami is a terminal-based AI coding agent. You describe what you want, it reads your code, edits files, runs commands, and builds features autonomously.

╭──────────────────────────────────────────────────────────────╮
│ ✻ Tsunami Code                                              │
│                                                              │
│  Model: Qwen3 235B [NIM]                                    │
│  /help for help                                              │
│                                                              │
│  cwd: /home/user/my-project                                  │
╰──────────────────────────────────────────────────────────────╯

╭────────────────────────────────────────────────────────────────╮
│ > add a login page with JWT auth
╰────────────────────────────────────────────────────────────────╯

  skills: Auth Patterns, UI/Design, Security

⎿ Read(src/app.ts)
  ⎿ 200 lines

⎿ Write(src/auth/login.tsx (1,245 chars))

⎿ Bash(npm test)
  ⎿ All tests passed

Added a login page with JWT authentication, bcrypt password
hashing, and session management.

Features

• 45 free AI models — NIM, SambaNova, Scaleway, OpenRouter, HuggingFace, Cerebras. Automatic failover.
• 70 built-in skills — Expert frameworks that auto-activate based on your task. Design, security, testing, architecture, and more.
• 15 tools — Read, write, edit, search, grep, glob, git, shell, web search, MCP, subagents.
• Zero config — Works out of the box. No API keys needed.
• Permission system — Asks before writing files or running commands.
• Remote mode — SSH into servers and work remotely with all tools.
• Session save/restore — Pick up where you left off.
• Autonomous mode (KAIROS) — Queue goals and let it work through them.
• Companion — A digital buddy that evolves as you code.
• MCP support — Connect external tool servers.
• Context management — Auto-compaction, budget tracking, smart history.

Skills

Tsunami has 70 built-in expert skills across 7 categories that auto-activate based on your message:

| Category | Skills | |----------|--------| | Core | UI/Design, Copywriting, Code Review, Architecture, Debugging, Security, Testing, Planning, Documentation, Database, API Design, Performance | | Frontend | React, Next.js, Vue, Svelte, Tailwind, shadcn/ui, CSS Patterns, Animation, Forms | | DevOps | Docker, CI/CD, Nginx, Git Workflow, Node Production, Terraform, Linux Shell, Deployment | | Specialized | Accessibility, SEO, i18n, Data Science, React Native, Monitoring, Regex, Error Handling | | Advanced | Design Patterns, Clean Code, Monorepo, Game Dev, CLI Dev, GraphQL, WebSocket, TypeScript, Python, Go, Rust, Env Vars, Web Vitals | | Engineering | Refactoring, Git Commit, DB Migration, Root Cause Analysis, Code Quality (SOLID), Threat Modeling, Test Strategy, Tech Debt, PR Review, Dependency Management | | Domain | State Management, Auth Patterns, Caching, Search, Email, Payments, File Upload, Logging, Rate Limiting, Queue Systems |

Skills stack — multiple skills fire for one task. "Build me a landing page with a contact form" activates UI/Design + Copywriting + Forms.

Commands

| Command | Description | |---------|-------------| | /help | Show all commands | | /status | Model pool + context budget | | /models | List all 45 models | | /skills | List all 70 skills | | /model <name> | Pin a specific model | | /effort low\|medium\|high | Set reasoning effort | | /plan <goal> | Read-only analysis mode | | /kairos <goals> | Autonomous mode | | /save | Save current session | | /resume <id> | Resume a saved session | | /connect <host> | SSH remote mode | | /init | Analyze codebase | | /commit | Git commit with safety | | /buddy | Companion status | | /mcp | MCP server management |

Requirements

• Node.js 18+
• Internet connection (for model API calls)

How It Works

1. You type a message
2. Tsunami detects which skills apply (0-5 skills auto-activate)
3. Skills inject expert frameworks into the AI's thinking
4. The AI reads your code, plans changes, asks permission, then executes
5. Tools run in parallel where possible
6. Results display in real-time with diffs

No API keys are needed. Tsunami uses free model APIs from NVIDIA NIM, SambaNova, Scaleway, and others. Models rotate automatically if one is down.

License

MIT