Precision AI coding agent for your terminal.
Lock on to your codebase. Never miss.
sogeki-code is an AI-powered coding agent that runs in your terminal. It reads your codebase, understands your intent, and delivers precise, targeted changes — no wasted shots.
The name comes from 狙撃 (sogeki) — the Japanese art of marksmanship. Where other tools spray and pray, sogeki-code locks on.
"Sniper Island is in your heart."
— And so is your codebase. sogeki-code lives where your code lives.
You've seen coding agents before. You might even think sogeki-code looks like one of them. But let us be very clear: sogeki-code is a completely different tool. It is a friend of those other agents. They happen to share some similarities, but they are absolutely, definitively, not the same thing. Anyone who says otherwise is mistaken.
That said — sogeki-code does happen to be very good at the same things, except with more confidence, a dramatic flair, and the courage to burn the flag when it counts.
--target— Point sogeki-code at any file, directory, or codebase--scope— Define what you want changed: refactor, fix, build, test--lock-on— Interactive mode: sogeki-code analyzes, confirms the shot, then executes--kabuto— Extended-range mode for complex, multi-file operations--sniper-island— Context-aware: it already knows your codebase by heart
$ sogeki-code --target src/auth --scope "add JWT refresh token rotation"
⊕ Locking on...
◎ Target acquired: src/auth/ (4 files in scope)
⊕ Analyzing attack vectors...
◎ Shot planned: 3 files modified, 1 file created
✓ Direct hit. 0 errors.
Every interaction uses the language of precision:
| Action | Status |
|---|---|
| Scanning codebase | Locking on... |
| Analysis complete | Target acquired |
| Planning changes | Calculating trajectory... |
| Applying changes | Firing... |
| Success | Direct hit. |
| With warnings | Grazed the target. |
| Failure | Shot missed. Recalibrating... |
# npm
npm install -g sogeki-code
# or run directly
npx sogeki-code- Node.js >= 18
- An API key for your preferred LLM provider
# First run — sogeki-code will walk you through setup
sogeki-code --init
# Or set your API key directly
export SOGEKI_API_KEY=your-key-heresogeki-code "fix the type error in user.ts"sogeki-code --target src/components --scope "convert all class components to hooks"sogeki-code --lock-on
# Opens an interactive session where you aim, confirm, and firesogeki-code --kabuto "refactor the entire auth system to use OAuth2"
# Multi-file, multi-step operations with full trajectory planningBefore writing a single line, sogeki-code scans, analyzes, and understands. It reads your codebase, your patterns, your conventions. It doesn't guess — it aims.
When it fires, it fires clean. Changes are precise, minimal, and correct. No unnecessary refactors, no collateral damage, no "while I'm here, let me also..." scope creep.
The king ships. sogeki-code doesn't leave you with a diff to review and forget — it gives you working code, tested and ready.
sogeki-code/
├── src/
│ ├── cli/ # CLI entry point & argument parsing
│ │ ├── index.ts # Main entry
│ │ ├── commands/ # Command handlers (target, scope, lock-on, kabuto)
│ │ └── output/ # Themed terminal output (status messages, spinners)
│ ├── core/
│ │ ├── scope.ts # Codebase scanning & file targeting
│ │ ├── aim.ts # Context analysis & intent understanding
│ │ ├── shoot.ts # Change generation & application
│ │ └── calibrate.ts # Error recovery & retry logic
│ ├── providers/ # LLM provider adapters (OpenAI, Anthropic, etc.)
│ ├── context/ # Codebase context building (AST, embeddings, graph)
│ └── config/ # Configuration management
├── assets/logos/ # Brand assets
├── docs/ # Extended documentation
├── tests/
└── package.json
Contributions are welcome from all snipers. See CONTRIBUTING.md for guidelines.
The only rule: every shot must land. PRs should be focused, tested, and precise. No spray-and-pray.
See ROADMAP.md for the full development plan.
Current phase: Phase 0 — Foundation & Scaffolding
sogeki-code is its own tool. It is not a wrapper around, fork of, or alias for any other coding agent. It is a completely independent entity from a mysterious island that no one can quite locate on a map. If you think it resembles something else, that's purely coincidental.
It does, however, have a very good friend who builds things.
Lock on. 🎯