seekcli

search the web from your terminal with your project as context.

seek detects your stack, attaches local files with @[file], pulls live web results, and streams a cited answer from the LLM you choose. one binary, fully keyboard-driven, all history saved locally.

install
quick start

install seek, run seek --setup, then seek "explain @[main.go]" from any repo.

inside seek

what seek adds, how the pipeline works, and the keybindings that keep it fast.

features

everything you need to stay in the terminal and stop context-switching to a browser.

ctx

project-aware by default

seek reads your repo to detect the language, framework, and dependencies, then biases every search toward your stack.

@[ ]

attach local files inline

type @[file] to attach code from your project. seek autocompletes paths and sends file contents alongside search results to your LLM.

db

persistent local history

every search is saved locally with full context. search your history, reopen past sessions, and pick up where you left off.

ms

visible latency

the status bar breaks down response time into search and LLM components so you always know where time went.

jk

keyboard-first controls

j/k navigation, slash command autocomplete, and file path suggestions. everything responds to the keyboard.

llm

local or hosted backends

run answers locally with Ollama or route through Groq, OpenRouter, or any OpenAI-compatible API. switch mid-session with /backend.

how it works

seek separates search from synthesis. your repo context shapes the query, Tavily fetches live results, and your LLM answers against both.

01

seek "explain @[main.go]"

ask from the repo you are already in. seek pulls project context and local file contents into the same request.

02

repo context + tavily search

seek biases the query toward your stack, fetches fresh pages, and keeps numbered sources separate from the answer.

03

your llm streams the answer

your chosen backend reads the search results and attached files, streams a cited answer, and seek saves the session locally.

keybindings
global
qquit and restore terminal
ctrl+cquit immediately
ctrl+lredraw screen
viewing
j / kscroll the answer
tabswitch to sources
fopen follow-up input
/search within the answer
y / Ycopy answer or code block
@[file]attach local file context
/historysearch local history
/contextinspect or toggle detected stack
sources
j / kmove selection
enter / oopen selected source
ycopy selected source url
tabreturn to summary
install

one command to install. one command to configure. then search from any repo.

install seek in one line

the installer pulls the latest release from GitHub. run seek --setup to configure your keys and start searching.

curl | sh
shell script
01

get tavily

grab a free key at tavily.com.

02

pick your backend

groq for speed (choose openai in setup), ollama to keep answers on your machine, or any OpenAI-compatible API.

03

run setup

run seek --setup, then seek "explain @[main.go]" from any repo.