Core

Tools

Jeden exposes typed tools through one capability registry. Every tool has a source, version, health state, policy classification, input schema, output schema, and handler identity.

Discover active tools

Terminal

$ jeden capabilities --json --cwd .
$ jeden tools --cwd .

/tools

The registry distinguishes executable healthy capabilities from planned or unavailable descriptors. Do not infer availability from a name alone; inspect health.state and ui.executable.

Built-in families

Family	Examples
Read	Directories, bounded text, binary files, images, documents, archives, notebooks, SQLite, URLs, and artifacts.
Search	Literal search, regex grep, globs, AST search, Git history, GitHub issues, and pull requests.
Write	Revision-guarded files, patches, anchored edits, archive entries, notebooks, SQLite rows, moves, and deletes.
Process	Package scripts, bounded commands, background processes, PTY sessions, Node evaluation, and Python evaluation.
Browser	Tabs, actions, extraction, screenshots, and browser state.
Agent state	Todos, memory, artifacts, conversation recall, user questions, and delegation.
Integrations	MCP tools/resources/prompts, language intelligence, debugging, SSH, collaboration, and custom project tools.

Bounded reads and selectors

Prefer narrow selectors to unbounded output. Text reads support line ranges, comma-separated ranges, raw content, and unresolved conflict views.

Selector examples

src/server.ts:80-140
src/server.ts:10-20,90-110
src/server.ts:raw
src/server.ts:conflicts
artifact://tool-output:1-120
database.sqlite:users:42

Guarded mutations

Existing text files return a digest and snapshot tag when read. A mutation must identify the state it intends to replace. If another actor changes the file first, the write fails instead of overwriting newer work.

write_file and apply_patch require the expected SHA-256 for existing files.
The unified writer uses revision guards for files, archives, notebooks, and SQLite.
Anchored edits use a snapshot path#TAG plus exact visible line anchors.
Mutations return native diffs and previews.

Two gates

--allow-write or --allow-command makes a tool available. Approval policy still decides whether each proposed effect may execute.