The harness she tells
you not to worry about.

unbloated, local first, agentic harness

curl -fsSL https://raw.githubusercontent.com/piskevalee-cpu/Seek/develop/install.sh | sh LINUX

Detected Linux · pipe the installer to sh

  • 5 crates
  • 1,500 token prompt budget
  • 0 telemetry
  • 2024 edition / Rust

Repo pulse

Open pull requests and the latest commit, fetched from GitHub. The bars are pixels, not a chart.

OPEN PULL REQUESTS
░░░░░░░░
…
LATEST COMMIT
…
…
NEWEST PULL REQUEST
…
…
fetching…

The interface, pixel for pixel

These are the real glyphs of the terminal UI · the 25×9 bitmap, the eight-cell streak, the rails and the rounded prompt. Try them below.

02 · THINKING

Eight cells. A streak travels through them and wraps at the right · the same wave as the logo's sheen.

03 · THE PROMPT
╭[no model selected]╮
│❯│
╰Enter sends · Alt+Enter newline╯

The model name sits in the top border. Type / for commands and skills, @ for project files.

04 · THE TRANSCRIPT
│❯ add a test for the parser
│I'll look at the parser and add a focused test.
│◇ read src/parser.rs

One column of colour per block: blue for you, magenta for the model, grey for tools. The band is yours; the answer is plain text.

06 · ONE HOME PER FACT

Nothing is shown twice. The METRICS block lives at the bottom of the sidebar, or in the footer when the sidebar is closed · never both.

The small pieces

Home widgets, permission prompts, the context meter. Hover the pixels and click the controls · they use the glyphs of the real interface.

07 · HOME WIDGETS

Two built-ins: git shows recent commits, usage shows lifetime tokens. Eight lines each, forty columns wide.

08 · PERMISSION PROMPT
? edit wants to run
rewrite src/parser.rs
↑/↓ choose · Enter confirm · Esc denies

The question, the summary and three choices. The marker is a real ❯; the selected row is a filled band.

09 · CONTEXT METER
~12.4k / 32k · 38%

The used context as a row of █ and ░, with the estimate and the real usage from the last response.

10 · PROCESSES
◇bashcargo test -j 2running
◇bashgit status --shortdone
◇websearch: rust 2024done

Every command registers a row. The diamond is the tool glyph; the state is text, never colour alone.

11 · TOGGLES

/tools and /skills are checklists. Click a row to flip it · the network tool is off by default.

12 · SMALL SCREEN

Below 56 columns the bitmap collapses to the word. Hover either line to send a wave through the blocks.

thin on purpose

A short prompt, a small toolset, and no hidden machinery.

01

Thin by design

System prompt plus default tool schemas fit in a 1,500-token budget · checked in CI. Five tools, nothing lurking.

02

Local is first-class

Discovers models in ~/seek/models/, starts llama serve, waits for health, reads the real context size and stops the server on exit.

03

Model-agnostic

Switch between a local server, Anthropic and OpenAI-compatible models between turns without losing the conversation.

04

Filesystem is config

No settings database. ~/seek/ holds GGUF models, SKILL.md skills, tool.toml tools, widgets and append-only session JSONL. Every config carries schema = 1, and install is idempotent.

05

The agent can search

web_search takes a query, not a URL, and returns numbered sources from a chain of engines.

06

Nothing hidden

Logs, process ids, context use and speed are always reachable. Every fact has exactly one home on screen.

Bring your own model

The provider boundary lives in one crate; the TUI never talks to an API directly.

LOCAL

llama.cpp

Point SEEK at the unified llama binary. Models are scanned from ~/seek/models/; the server runs as its own process group and shuts down cleanly.

CLOUD

Anthropic

Native messages API with streaming tool use, reasoning variants and prompt caching. Keys live in the environment or state/auth.json.

CLOUD

OpenAI-compatible

Any endpoint that speaks the OpenAI chat protocol · gateways, local servers, hosted models · behind the same catalog and stream parser.

API keys are never written to config.toml or providers.toml, and are redacted wherever they could be logged.

extend without rebuilding

There is no settings database. ~/seek/ is the config: drop a folder in, toggle it with /skills or /tools, and it is live on the next turn. Each contract carries schema = 1, and install.sh is idempotent, so it never overwrites a file of yours.

  • skills/ uses the Agent Skills SKILL.md format; only the name, description and path enter the prompt
  • tools/ declares tool.toml, schema.json and a run script that reads JSON on stdin
  • widgets/ prints up to eight lines from a run script on the home screen
  • state/ keeps append-only sessions, user.toml and auth.json at mode 0600
  • API keys never go in config.toml or providers.toml
~/seek/
├── models/      # gguf files
├── skills/      # SKILL.md
├── tools/       # tool.toml + run
├── widgets/     # widget.toml + run
└── state/
    ├── auth.json      # 0600
    ├── user.toml
    └── sessions/      # append-only jsonl

roadmap

The spec is the source of truth; later milestones are not pulled forward.

MilestoneScopeStatus
v0.1.0Workspace, CI, theme, logo, layout, prompt bar, sidebardone
v0.2.0Providers, reasoning variants, /provider, sessionsdone
v0.3.0Agent loop, tools, permissions, processesdone
v0.4.0llama.cpp supervisor, models folder, launch optionsdone
v0.5.0Context accounting, METRICS block, /compactdone
v0.6.0Skills, external tools, toggles, /initdone
v0.7.0Home widgets, install.sh, rate limits, web searchdone
v0.8.0 – v1.0.0Hardening, contract review, contracts frozenin progress

Ready when you are.

Clone, install, and pick a model when you're ready. SEEK opens on the chat.

Star on GitHub