A lean TUI AI assistant: run your tools, stay in charge, zero magic tricks.
- Installation
- Features
- Editor Integrations
- Configuration
- Modes
- Tools
- Key Bindings
- Development
- Contributing
- Roadmap
- FAQ
curl -fsSL \
https://raw.githubusercontent.com/kamilmac/unibear/main/install.sh \
| bashEnsure
OPENAI_API_KEYis set in your environment. (Support for more LLMs is on the way)
Launch Unibear in your git repository:
unibear- 🚀 Work in Prompt or Visual (Vim/Helix-like) modes
- 🔍 Inject arbitrary file context
- 🔧 Built-in Git, filesystem and web-search tools
- 🤝 Plan & pair-program with your AI buddy before applying edits
- 🖥️ Responsive TUI
- 📁 Ability to use a local LLM server that supports the OpenAI chat completions API (eg. Ollama)
Only one Unibear instance at a time (it runs a local server).
Add a buffer to Unibear’s context:
unibear add_file <path/to/file>Example Helix mapping:
# ~/.config/helix/config.toml
[keys.normal]
C-a = [":sh unibear add_file %{buffer_name}"]Create ~/.config/unibear/config.json:
{
"model": "o4-mini",
"system": "Your custom system prompt",
"port": 12496,
"theme": "dark",
"user_name": "Alice",
"key_bindings": {
"useGitTools": ":",
"useEditTools": "+",
"useWebTools": "?"
}
}Unibear supports using local LLMs via the OpenAI chat completions API by providing OPENAI_API_URL environment variable.
# Example using Ollama:
OPENAI_API_URL=http://localhost:11434/v1 unibear- Press
i - Type your prompt and hit ↵
- Invoke tools like
edit,git, orweb_search
- Press
Esc - Navigate output with
j/k(orJ/Kfor big scroll) - Select (
v), yank (y), paste (p), delete (d) - Jump to top (
gg) or end (G/ge)
| Tool Group | Key | Commands |
|---|---|---|
| Default | – | read_multiple_files, search_files, app_control_reset_chat, app_control_quit, help |
| Git | : |
git_auto_commit, git_review, git_create_pr_description |
| Edit | + |
edit_file |
| Web | ? |
web_search |
{
"promptMode": ["i"],
"visual": {
"moveUp": ["k"],
"moveDown": ["j"],
"bigMoveUp": ["K"],
"bigMoveDown": ["J"],
"select": ["v"],
"yank": ["y"],
"paste": ["p"],
"delete": ["d"],
"goToTop": ["gg"],
"goToEnd": ["G", "ge"]
},
"tools": {
"git": [":"],
"edit": ["+"],
"web": ["?"]
}
}Clone the repo and get going locally:
git clone https://github.com/kamilmac/unibear.git
cd unibearLeverage the built-in Deno tasks:
# watch & run in dev mode
deno task dev
# compile a standalone binary
deno task compile
# faster compile skipping type checks
deno task compile-no-checkContributions welcome! Please open issues or pull requests with clear
descriptions. Follow DWYL style guide and run deno fmt & deno lint.
- Better Windows build support
- Enhanced LLM model options
- Support for images
- Tools as plugins architecture
Q: Port already in use?
A: Run lsof -i :<port> and kill the process or change port in config.
Q: Invalid API key?
A: Ensure $OPENAI_API_KEY is set correctly.
MIT