Get started

ShepAIrd gives coding agents a map of your codebase and a memory of what the team has already learned. You search both with one question. The command is shepaird.

Install

Access is by a separate evaluation agreement. Use your authorized build and the setup instructions supplied for your pilot. The example below requires a running daemon, a registered indexed repository, and credentials with context:read permission.

An example request

A query in a configured evaluation

shepaird call context.search --input '{
  "query": "Where is refund eligibility checked?",
  "org_id": "YOUR_ORG_ID",
  "actor_id": "YOUR_ACTOR_ID",
  "budget_tokens": 2000,
  "limit": 10,
  "explain": true
}'

Replace the organization and actor placeholders with your pilot identifiers. Access is determined by your authenticated identity. Model-assisted features require configured providers; unavailable retrieval channels are reported in the response.

What that does

init: Creates local data for this machine and starts ShepAIrd.
index run: Reads the repo and builds a map you can search.
context search: Asks one question. Results include available source references and missing-channel reasons.
memory add: Saves a finding pointed at real code.
brief: The handful of facts the next session should open with.

Where it lives

Data folder: ~/.shepaird on a new machine, or ~/.memory-layer if that folder already exists.
Repo config: shepaird.toml in the project you indexed.