Repository

Understand the code. Keep the context.

Repository is a per-project page for the local code index, project memory and reviewed learning. Right-click a project in the Synoec area sidebar and choose Repository. Back to chat returns to the thread.

Tab	Shows
Codebase	Search and browse the indexed source map
Code Index	Index health, coverage, mode and maintenance
Memory	Project notes, Chat recall and Workspace memory — see Workspaces and memory
Learning	Project Learning proposals and accepted lessons — see Learning

Code Index

The index is a local, rebuildable map of declarations, imports and structural relationships, parsed with tree-sitter. It is stored separately from saved memories and conversation recall, and nothing is uploaded. Builds run in a background worker, so a refresh never holds up a turn, and engines that share a repository build it one at a time and reuse each other’s result. After a failed refresh, queries report the failure at once and retry after five minutes or when files change; Rebuild Code Index retries now.

Control	Use
Update Index	Build or refresh the map now
Browse Code	Open Codebase once the index is ready
Update this project’s source map	Off, On demand (default: build when asked, check for changes before each query) or Continuous (watch changes while the repository engine is active)
Rebuild Code Index	Rebuild the index from source
Clear Code Index…	Remove the local cache; source files, memories and conversations are kept
Cancel operation	Stop a running build

The summary lists Source files, Symbols, Other files and Local cache, plus Indexed languages and Index activity. Formats without a structural parser (Markdown, JSON and similar) count as other files — an expected exclusion, still readable in Explorer. Parser recoveries are reported separately and can mean some relationships are incomplete.

Codebase

Search with Search code paths and declarations, then choose a view:

View	Use
Files (default)	Browse folders and files; All files returns to the root
Map	Folder cards with languages, file and symbol counts. Folders show containment; only indexed imports establish dependencies
Graph	Pannable, zoomable relationship graph with Node type and Relationship filters, shortest inbound search paths, draggable nodes, Fit graph, Export SVG… and Export PNG…

On a declaration, Trace follows its indexed relationships and Impact lists files likely affected, marking tests. Both exclude heuristic relationships; they are structural facts, not runtime frequency or compiler certainty.

Project instructions

Synoec reads AGENTS.md and .synoec/instructions.md at the project root and in each directory on the way to the files a task targets. Up to 16 files and 64 KiB in total are loaded (32 KiB per file); symlinked, oversized or invalid files are skipped with a diagnostic. The effective set appears under instructions in Context.

Agent tools

Agents explore code with read-only tools. The first four read the Code Index; the rest work without it.

Tool	Answers
CodeSearch	Paths, declarations, imports and references in the index. When the index cannot answer, it points the agent to Grep
CodeOutline	One file’s declarations, imports, exports and parser notes
CodeTrace	Indexed callers and callees of a symbol, with confidence labels
CodeImpact	Dependent symbols and likely test files
RepoMap	A bounded map of a directory, with ignored paths excluded and language counts
SymbolSearch	Declarations matching a name across non-ignored source files
Definition / References	Where the identifier at a source position is declared or used (lexical)

These tools search every folder the chat may read: its project and any directories you approved. Results pass through ordinary tool and conversation authority. At the start of a turn Synoec may look up task-relevant paths in the last complete index (within 1.5 seconds) to pick project instructions; it never injects source on its own.

CLI

synoec intelligence status --json
synoec intelligence mode on-demand
synoec intelligence mode continuous --default
synoec intelligence build
synoec intelligence reindex
synoec intelligence clear --yes
synoec intelligence languages
synoec intelligence inventory --json

Commands act on the current project; --root PATH targets another checkout.

Limits

• The Codebase and Graph views load a bounded subset; Partial index view marks capped data. A missing link is not proof of no dependency.
• Imports into external packages, wildcard imports and ambiguous roots stay unresolved. Macros are not expanded.
• Off disables code queries and automatic indexing for the project.

Related

• Repository Intelligence contract — supported languages, storage, parser provenance
• Project intelligence contract · Context planning

Decisions behind this page: 0093, 0213 — see the decisions index.