███████╗ ██████╗ ███╗   ██╗ █████╗      ██████╗ ██████╗ ██████╗ ███████╗
██╔════╝██╔═══██╗████╗  ██║██╔══██╗    ██╔════╝██╔═══██╗██╔══██╗██╔════╝
███████╗██║   ██║██╔██╗ ██║███████║    ██║     ██║   ██║██║  ██║█████╗  
╚════██║██║   ██║██║╚██╗██║██╔══██║    ██║     ██║   ██║██║  ██║██╔══╝  
███████║╚██████╔╝██║ ╚████║██║  ██║    ╚██████╗╚██████╔╝██████╔╝███████╗
╚══════╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝     ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝

Sona is a highly efficient, cost optimized CLI Native AI agent for your daily use. Fast. Capable. Cost-effective.

Website: sonacode.dev

Sona Code is built for developers who ship daily and for those who think most used CLI agents have become very expensive.

Sona is built on top of the Deepseek v3/r1 model to minimize token cost. We also integrated our own tested compression algorithm to even minimize inefficient costs on tokens. Sona Code handles the heavy lifting on navigating complex codebases really fast, managing multi file refactors, debugging across services, and working with large GitHub repositories so you can focus on what matters. Whether you're deep in a monorepo, spinning up a new feature, or fixing a production bug, SONA keeps up.

Optimized for daily coding sessions. Instant startup. Persistent workspace memory. No context window anxiety. We just began building it, so your welcome to use it and write me feedback on X - @zeradamfantaye.

Install

npm install -g sona-code

Quick Start

sona

On first run, you'll be prompted to enter your DeepSeek API key. Get one at platform.deepseek.com.

Capabilities

• Codebase navigation — Read, write, and edit files across your entire project
• Shell integration — Execute commands, run builds, manage dependencies
• Intelligent search — Find files by pattern, search content with regex, understand project structure
• Git workflows — Status, diff, commit, log—all without leaving the conversation
• Workspace memory — Remembers files touched, commands run, and tasks completed across sessions

Commands

| Command | Description | |---------|-------------| | /help | Show available commands | | /plan | Toggle plan mode (review changes before applying) | | /api | Configure API provider | | /model | Switch model | | /expand | Expand collapsed diff sections | | /clear | Reset current session | | /forget | Clear workspace memory | | /quit | Exit |

Plan Mode

Review and approve changes before they're applied:

> /plan on
 ✓ Plan mode enabled

[PLAN] > create a config.ts file

  📋 Staged for review:
  ┌─────────────────────────────────────────┐
  │ + CREATE  config.ts                     │
  ├─────────────────────────────────────────┤
  │    1 + export const config = { ... }    │
  └─────────────────────────────────────────┘

> /plan apply    # Review and apply all changes
> /plan review   # See pending changes
> /plan clear    # Discard pending changes

Why SONA?

Speed. Powered by DeepSeek's optimized inference. Responses in seconds, not minutes.

Cost. 100x cheaper than premium alternatives. Run it all day without watching your bill.

Memory. Pick up where you left off. SONA tracks your work across sessions—files modified, commands executed, tasks in progress.

Zero friction. One install. One command. Start coding.

Example

$ sona

> read the auth module and explain how it works

  · src/auth/index.ts 2.1KB
    142 lines
    
  The auth module uses JWT tokens with a 24h expiry...

> add rate limiting to the login endpoint

  writing src/auth/index.ts

  +  import rateLimit from 'express-rate-limit';
  +  const loginLimiter = rateLimit({
  +    windowMs: 15 * 60 * 1000,
  +    max: 5
  +  });

  ✓ +8 lines

> run the tests

  Running: npm test
  ✓ 23 passed

Configuration

Config is stored in ~/.sona/config.json:

{
  "provider": "deepseek",
  "model": "deepseek-chat",
  "apiKey": "sk-..."
}

Workspace memory is stored in .sona/memory.json in each project directory.

Requirements

• Node.js 18+
• DeepSeek API key (or OpenAI/Anthropic if preferred)

License

MIT