Show HN: I built Solveig, it turns any LLM into an assistant in your terminal (github.com)
Watch 45s demo: https://asciinema.org/a/p5mzDGAoHTUHNEaVeROHpFibx
---
QUICK START
# Install
pip install solveig
# Run from local models or remote APIs
solveig -u "http://localhost:5001/v1" "Create a demo BlackSheep webapp"
# Mix config files and CLI args
solveig -c solveig.config -k "<API_KEY>" -m "gpt-5"
---
FEATURES
AI Terminal Assistant - Automate task planning, file management, code analysis and system management using natural language in your terminal.
Safe by Design - Granular controls with pattern-based permissions. File operations prioritized, and shell commands can be disabled.
Plugin Architecture - Extend capabilities through drop-in plugins. Add SQL queries, web scraping or block dangerous commands with 100 lines of Python.
Modern CLI - Clear interface with task planning and listing, file content previews, diff editing, API usage tracking, code linting, waiting animations and rich tree displays for informed user decisions.
Provider Independence - Works with any OpenAI-compatible API, including local models.
tl;dr: similar idea to Claude Code (https://claude.com/product/claude-code) or Aider (https://aider.chat/), focusing on providing explicit user consent, granular configuration, drop-in plugins and the ability to integrate any model, backend or API.
See the Features for more: https://github.com/FSilveiraa/solveig/blob/main/docs/about.m...
---
TYPICAL TASKS
- "Find and list all the duplicate files inside ~/Documents/" - "Check my essay Final.docx for spelling, syntax or factual errors while maintaining the tone" - "Refactor my test_database.ts suite to be more concise" - "Try and find out why my computer is slow" - "Create a dockerized BlackSheep webapp with a test suite, then build the image and run it locally"
---
So it's a coding assistant?
You can use Solveig for analyzing, editing and testing your code, and all of these scenarios have received significant support through development features like code linting. But I didn't build Solveig with a single kind of use case in mind.
---
So it's yet another LLM-in-my-terminal?
Sort of. Solveig tries to do a few things that other tools don't, and to do the shared features with clearer UX, explicit consent, and deeper configuration. It's not an IDE extension, doesn't require a GUI, and it's not built for a specific user type or scenario.
At the same time, Solveig's competitors are mature projects with real user testing that you should check out. I've written a detailed comparison (https://github.com/FSilveiraa/solveig/blob/main/docs/compari...) to similar tools in the market in the docs.
---
UPCOMING
I have a Roadmap ( No comments yet.0 comments
[ 3.2 ms ] story [ 12.2 ms ] thread