@synoppy/cli
v1.0.7
Published
AI-powered development assistant for your terminal
Maintainers
Readme
What is Synoppy?
Synoppy is an autonomous AI coding agent that lives in your terminal. It doesn't just suggest code — it reads your codebase, writes files, runs commands, fixes errors, and verifies the build. All from a single prompt.
❯ Build me a SaaS landing page with pricing, testimonials, and dark mode
● Scaffold(Next.js 15 + Tailwind v4)
● Write(Navbar.tsx) 87 lines
● Write(Hero.tsx) 124 lines
● Write(Features.tsx) 156 lines
● Write(Pricing.tsx) 203 lines
● Write(Testimonials.tsx) 142 lines
● Write(Footer.tsx) 96 lines
● Write(globals.css) 284 lines
● Bash(npm install) added 12 packages
● Bash(npm run build) ✓ clean build
◆ Crafted in 6m 42s — 8 components, production-ready.Quick Start
# Install globally
npm install -g @synoppy/cli
# Login (opens browser for auth)
synoppy login
# Start building
synoppyThat's it. Three commands. Start prompting.
12 AI Models, 3 Providers
Switch models mid-conversation with /model. Use the right model for each task.
Claude (Anthropic)
| Model | Highlights | Output | Plan | |-------|-----------|--------|------| | Opus 4.6 | Most intelligent, adaptive thinking | 128K | Pro+ | | Opus 4.6 (1M) | Opus + 1M context window | 128K | Pro+ | | Opus 4.5 | Advanced reasoning, extended thinking | 64K | Pro+ | | Sonnet 4.6 | Best balance, adaptive thinking | 64K | All | | Sonnet 4.6 (1M) | Sonnet + 1M context window | 64K | Pro+ | | Sonnet 4.5 | Reliable, extended thinking | 64K | All | | Haiku 4.5 | Fastest Claude, great for quick tasks | 64K | All |
Gemini (Google)
| Model | Highlights | Plan | |-------|-----------|------| | Gemini 3.1 Pro | Deep reasoning, SOTA | Pro+ | | Gemini 3 Flash | Fast multimodal | All | | Gemini 3.1 Flash-Lite | Most affordable | All |
DeepSeek
| Model | Highlights | Plan | |-------|-----------|------| | DeepSeek V3 | Budget-friendly ($0.14/M input) | All |
33 Built-in Tools
Synoppy has 33 tools it uses autonomously — no plugins needed:
| Category | Tools |
|----------|-------|
| File Ops | read_file write_file edit_file multi_edit delete_file move_file copy_file undo_file create_directory |
| Search | glob grep search_files search_and_replace list_files explore_directory |
| Build & Run | run_command scaffold_project verify_project batch |
| Git | git_status git_diff git_commit git_branch git_log |
| Planning | write_plan exit_plan_mode update_plan_task todo_write todo_read |
| Web | web_search fetch_url |
| AI | ask_user_question invoke_agent |
Scaffold 55+ Frameworks
Next.js React Vue Svelte Angular Astro Nuxt Remix Express Fastify NestJS Django Flask FastAPI Rails Spring Boot Go Rust Flutter React Native Electron and more.
Key Features
Adaptive Thinking
Sonnet 4.6 and Opus 4.6 think before they code. Deeper reasoning, better architecture decisions, fewer mistakes.
BYOK (Bring Your Own Key)
Have API keys? Use them for unlimited usage on any plan. Your keys, our agentic framework.
/byok anthropic sk-ant-...
/byok gemini AIzaSy...
/byok deepseek sk-...Session Memory
Resume where you left off. Context persists across conversations.
/resume # Continue interrupted session
/sessions # Browse all sessions
/compact # Compress conversation to free contextBuild Verification
Synoppy verifies its own work. After writing files, it runs the build, reads errors, fixes them, and rebuilds until clean.
Smart Modes
/mode auto # Full autonomy (default)
/mode plan # Creates a plan, asks for approval before building
/mode confirm # Asks permission for each file changeCommands
Session /new /clear /resume /sessions /compact /merge /export
Models /model /thinking /byok /provider
Planning /plan /mode /todo
Account /login /logout /status /usage /whoami
Project /init /project /memory /context
Tools /review /security-review /doctor
Config /config /theme /permissions /output-style
Help /help /?Plans & Pricing
50% OFF Launch Offer — auto-applied at checkout.
| | Free Trial | Pro | Pro+ | |---|---|---|---| | Price | $0 | ~~$20~~ $10/mo | ~~$60~~ $30/mo | | Duration | 5 days | Ongoing | Ongoing | | Credits | 1,000 | 2,000/mo | 6,000/mo | | Models | Haiku, Sonnet 4.5/4.6, Flash, DeepSeek | + Opus 4.5, Gemini Pro | + Opus 4.6, 1M context | | BYOK | ✅ | ✅ | ✅ | | Annual | — | $16/mo (20% off) | $48/mo (20% off) |
BYOK users get unlimited usage on any plan — bring your own Anthropic, Google, or DeepSeek API keys.
Standalone Commands
Use Synoppy for one-shot tasks without entering the REPL:
synoppy ask "explain this error" --file src/app.tsx
synoppy commit # AI-generated commit message
synoppy review src/api.ts # Code review
synoppy fix src/utils.ts # Fix issues
synoppy explain src/auth.ts # Code explanation
synoppy test # Run tests with AI analysis
synoppy docs src/lib/ # Generate documentation
synoppy audit # Security audit
synoppy debug src/app.tsx:42 # Debug specific line
synoppy refactor src/old.ts # Refactor code
synoppy optimize src/heavy.ts # Performance optimizationRequirements
- Node.js 18+
- npm 8+
- Windows, macOS, or Linux
Links
- Website — synoppy.com
- Documentation — synoppy.com/docs
- Pricing — synoppy.com/pricing
- Changelog — synoppy.com/changelog
- Blog — synoppy.com/blog
- X / Twitter — @SynoppyAI
- Support — [email protected]
License
Proprietary. Copyright (c) 2026 Saanora Technologies. All rights reserved. See LICENSE for details.
