seekr is a high-performance AI Agent Manager featuring a sleek Terminal UI. While originally built as a DeepSeek-native client (and highly optimized for its reasoning models), seekr now features full OpenAI API integration, allowing you to use multiple models and providers. It brings the power of autonomous agents directly to your terminal with a robust toolset for shell execution, file management, and web exploration.
- Unlimited Context Window: Never run out of memory. Seekr automatically summarizes past conversation segments and injects them into the current context as a "sliding window."
- Interruptible Agent Loop: Real-time user steering. Interrupt the agent mid-thought to provide new context or directions.
- True Multi-Tool Parallelism: Execute multiple independent tool calls (reading files, searching web, etc.) concurrently for 5-10x performance gains.
- Premium TUI Experience: Beautiful, icon-based headers and a custom-built, wrapping-aware scrolling engine for a smooth conversation flow.
- Dynamic Skills System: Load and execute custom tools via simple JSON definitions and shell scripts (Python, JS, Bash, etc.).
- Terminal UI (TUI): Built with
ratatuifor a responsive, multi-tabbed interactive experience. - Multi-Model & OpenAI API Support: Full support for configuring multiple LLM providers (OpenAI, DeepSeek, Local, etc.) via the standard OpenAPI format, while maintaining native optimizations for DeepSeek's reasoning models.
- Extensible Skills System: Refactored tool architecture allowing for global and repository-specific custom skills.
- Autonomous Tools:
- Shell: Execute terminal commands with built-in sandboxing, timeouts, and background execution.
- File Edit: Sophisticated file manipulation using patches and diffs.
- Web: Real-time search and scraping.
- Task Management: Goal planning and progress tracking.
- Parallel Execution Engine: Optimized batch processing of independent actions in a single turn.
- Rich Activity Stream: Real-time visibility into agent thoughts and tool executions with diff previews and parallel task numbering.
- Unlimited Context Window: Automatically summarizes and prunes long-running conversations to maintain "human-like" working memory without hitting model context limits.
- Session Persistence: Automatic saving and loading of chat history, agent state, and context summaries.
- Seekr Doctor: Built-in diagnostics command to verify system health and API connectivity.
- Syntax Highlighting: Add full syntax highlighting for code blocks in the chat window.
- Focus Actions: Add context-aware option menus and interactive actions based on the current panel focus (Chat vs Tasks).
- Advanced Thread Management: Add a dedicated UI view for managing long-running background processes.
- Advanced Context Management: Sliding-window and basic pruning for long-running conversations.
- Parallel Execution Engine: Optimized batch processing of independent actions.
⚠️ Large Result Lag: Rendering extremely large tool outputs (1MB+) can cause temporary TUI stutter.⚠️ Resize Artifacts: Rare layout flickering if the terminal is rapidly resized during an active API stream.
- Rust (latest stable version)
- An API Key for DeepSeek or any compatible OpenAPI-format provider (e.g., OpenAI, local LLMs).
The fastest way to get started is to download the pre-compiled binary from our Latest Release.
# Download the binary
curl -L -O https://github.com/kodr-pro/seekr/releases/download/v0.1.2/seekr-v0.1.2-linux-x86_64
# Make it executable and move to path
chmod +x seekr-v0.1.2-linux-x86_64
sudo mv seekr-v0.1.2-linux-x86_64 /usr/local/bin/seekrIf you prefer to build it yourself or are using a different architecture, ensure you have Rust installed:
git clone https://github.com/kodr-pro/seekr.git
cd seekr
cargo install --path .On your first run, seekr will guide you through a setup wizard to configure your first API provider and preferences.
| Command | Description |
|---|---|
seekr |
Launch the main TUI application. |
seekr doctor |
Run system diagnostics and health checks. |
seekr --resume <session_id> |
Resume a previous session by its ID. |
| Key | Action |
|---|---|
Tab |
Switch focus between Chat and Tasks panel. |
Ctrl+S |
Open Session List (resume/delete previous chats). |
Ctrl+R |
Toggle visibility of agent reasoning tokens. |
Ctrl+L |
Clear the current chat history. |
F1 |
Show the help / shortcut guide. |
PageUp/Dn |
Scroll chat or tasks quickly. |
Esc/Ctrl+C |
Quit the application. |
seekr features a dynamic skills system. It loads tools from:
- Bundled Core Skills: Essential file, shell, and task tools.
- Global Skills: Located in
~/.config/seekr/skills/. - Local Skills: Located in
./.seekr/skills/within your current working directory.
Each skill is a directory containing a skill.json definition and any necessary scripts (Python, Shell, etc.).
seekr stores its configuration in ~/.config/seekr/config.toml. You can manually edit this file or use the built-in setup wizard.
[[providers]]
name = "DeepSeek"
key = "your-api-key-here"
model = "deepseek-chat"
base_url = "https://api.deepseek.com"
active_provider = 0
[agent]
max_iterations = 25
auto_approve_tools = false
working_directory = "."
context_window_threshold = 40
context_window_keep = 10
[ui]
theme = "dark"
show_reasoning = trueFor more detailed guides and API references, check out our Documentation.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the Polyform Prosperity License 1.0.0. See LICENSE for more information regarding personal and commercial use.
Built with care by kodr