Introduction
Welcome to the seekr documentation.
seekr is an autonomous AI agent manager designed specifically for the terminal. Built with Rust, it provides a fast, reliable, and powerful interface for managing AI-driven tasks within your local development environment. While it is heavily optimized as a DeepSeek-first client, it features full OpenAPI integration, allowing you to seamlessly configure and use models from any compatible provider.
Why seekr?
- Native Speed: Written in Rust for minimal overhead and maximum performance.
- Multi-Model Support: Full OpenAPI integration allows you to run multiple models and providers.
- DeepSeek Optimized: Built as a DeepSeek original, highly optimized for DeepSeek's latest reasoning models.
- Local Control: All agent activities happen in your terminal, under your supervision.
- Rich TUI: A sophisticated Terminal User Interface that doesn't sacrifice power for aesthetics.
The Agent Loop
seekr runs a continuous loop where the agent:
- Receives a objective or task.
- Analyzes the current state.
- Decides which tools to use. Parallel Execution: seekr can execute multiple independent tool calls simultaneously in a single turn.
- Executes the tools and observes the outcome.
- Repeats until the task is complete.
Skills & Extensibility
Custom capabilities can be added through Skills. A skill is a collection of tools (scripts or commands) that can be loaded globally or for specific repositories.
Activity Stream
The Activity Stream provides real-time visibility into every tool execution, including diffs for file edits and output summaries for shell commands.
Explore the Docs
- Getting Started: Installation and first-run guide.
- Configuration: Detailed breakdown of
config.toml. - Built-in Tools: Learn about Shell, File, and Web capabilities.
- User Interface: Master the TUI layout and shortcuts.
- The Agent Loop: Understand how SEEKR thinks and acts.