reyn source

Manage indexed sources — the named document collections created by a safe-mode indexing step calling embed_and_index(). See Concepts: RAG for the mental model and indexing workflow (there is no reyn run index_docs one-command indexing skill).

Synopsis

reyn source list   [--json]
reyn source describe <NAME>
reyn source rm     <NAME> [-y]

Description

reyn source is the primary interface for inspecting and removing the indexed sources stored under .reyn/cache/index/ (manifest at .reyn/config/index/sources.yaml). This command group does not create or update sources — see Concepts: RAG — Quick start for how to create one.

---

Subcommands

list

List all indexed sources registered in .reyn/config/index/sources.yaml.

reyn source list [--json]

Description: Displays each source name with its description, chunk count, embedding model, and last-indexed timestamp. If no sources are indexed, prints a getting-started hint.

Options:

Flag	Description
--json	Output as a JSON array instead of the default table. Each element includes name, description, path, chunk_count, embedding_model, last_indexed, and backend.

Examples:

reyn source list

Output:

NAME          DESCRIPTION                              CHUNKS  MODEL                    LAST INDEXED
────────────────────────────────────────────────────────────────────────────────────────────────────
memory        User notes / past session memos          142     text-embedding-3-small   2026-05-09T10:14:00Z
my_docs       Project documentation                    89      text-embedding-3-small   2026-05-10T08:30:00Z
reyn_code     Reyn Python framework source code        1247    text-embedding-3-small   2026-05-10T08:45:00Z

If no sources are indexed:

No indexed sources yet.
Try: reyn run index_docs --source <name> --path "<glob>" --description "<description>"

This hint text is stale — it references the removed index_docs skill. There is no CLI command to create a source today; see Concepts: RAG — Quick start for the current safe-mode embed_and_index() path.

# Machine-readable output
reyn source list --json

Exit codes:

Code	Meaning
0	Success (including the empty-sources case).
1	I/O error reading sources.yaml.

---

describe <NAME>

Show detailed information for a single indexed source.

reyn source describe <NAME>

Description: Prints the full metadata for one source: name, description, path glob, chunk count, embedding model, storage backend, storage path, and last-indexed timestamp.

Examples:

reyn source describe my_docs

Output:

Source: my_docs
  Description:     Project documentation
  Path:            docs/**/*.md
  Chunks:          89
  Embedding model: text-embedding-3-small
  Backend:         sqlite
  Index path:      .reyn/index/my_docs/index.db
  Last indexed:    2026-05-10T08:30:00Z

Exit codes:

Code	Meaning
0	Source found and described.
1	Source not found (<NAME> is not in sources.yaml).

---

rm <NAME>

Remove an indexed source and all its associated index data.

reyn source rm <NAME> [-y]

Description: Drops the source's vector index from disk (.reyn/index/<name>/index.db) and removes the corresponding entry from .reyn/index/sources.yaml. The source will no longer appear in reyn source list, and the LLM will no longer see it in the system prompt.

By default, prompts for confirmation before deleting. Use -y to skip the prompt.

Internally invokes the index_drop op, which requires the permissions.index_drop permission (default: ask). On first run, reyn will prompt once for this permission unless it has been pre-approved.

Options:

Flag	Description
-y, --yes	Skip the confirmation prompt. Useful in scripts or when iterating on indexing strategies.

Examples:

# Interactive — shows a confirmation prompt
reyn source rm my_docs

Output:

Remove source 'my_docs' and delete .reyn/index/my_docs/index.db? [y/N] y
Source 'my_docs' removed.

# Skip the prompt
reyn source rm my_docs -y

# Typical iteration workflow: drop, then re-run your indexing step with a different chunking approach
reyn source rm my_docs -y
python my_project/index_docs.py   # see Concepts: RAG — Quick start

Exit codes:

Code	Meaning
0	Source removed successfully.
1	Source not found, or I/O error removing the index file or updating sources.yaml.

---

See also

• Concepts: RAG — indexing workflow, source model, and chunker overview
• recall tool — LLM-facing retrieval tool
• Concepts: permission model — index_drop permission gate