Maintainers
Pricing
Enterprise
More
More
Documentation
Try Live
Rankings
Install
Blog
Docs7
Ask
New
Add Docs
Synrepo
https://github.com/whit3rabbit/synrepo
Admin
A context compiler for AI coding agents.
Tokens:
104,170
Snippets:
1,432
Trust Score:
9.1
License:
MIT
Update:
4 months ago
Context
Chat
Benchmark
Latest
Show doc for...
Code
Info
Show Results
Tokens:
Raw
Copy
Link
Tokens:
Raw
Copy
Link
### Full Synrepo Onboarding Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Guides through the full Synrepo onboarding process, either via an interactive TUI wizard or scripted setup. Supports explaining steps and overriding the repository path. ```bash cargo run -- setup # full onboarding: interactive TUI wizard (mode + agent target + explain) cargo run -- setup <tool> # full onboarding: scripted (init + shim + MCP register + first reconcile); --explain appends the explain sub-wizard ``` -------------------------------- ### Starting MCP Server Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Commands to start the stdio MCP server for repository context. ```bash synrepo mcp # server for current repo when started there synrepo mcp --repo <path> # server with a default repo synrepo mcp --allow-overlay-writes # expose overlay note/commentary writes synrepo mcp --allow-source-edits # expose anchored source edit tools ``` -------------------------------- ### Setup, Uninstall, and Search Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Commands for onboarding, uninstalling, and performing lexical searches within the repository. ```bash cargo run -- setup # full onboarding: interactive TUI wizard (mode + agent target + explain) cargo run -- setup <tool> # full onboarding: scripted (init + shim + MCP register + first reconcile); --explain appends the explain sub-wizard cargo run -- uninstall [--apply --force] # guided full teardown; keeps .synrepo/ and ~/.synrepo data unless --delete-data is selected cargo run -- search <query> # lexical search ``` -------------------------------- ### Registering a New Project Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Add another repository to an existing global MCP setup. This command bootstraps .synrepo/ if needed. ```bash cd /path/to/another-repo synrepo project add . ``` -------------------------------- ### Start MCP Server Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Starts the MCP server, either over stdio or for a specific repository. ```bash cargo run -- mcp # start MCP server over stdio cargo run -- mcp --repo <path> # start MCP server for a specific repo ``` -------------------------------- ### Basic Synrepo Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Run these commands for initial setup, status checks, and basic code interaction. ```bash synrepo setup codex # or claude, cursor, open-code, etc. synrepo status # check freshness and integration health synrepo ask "where is MCP search implemented?" synrepo explain src/surface/mcp/search.rs --budget 1000 synrepo tests src/surface/mcp/search.rs --budget 1500 ``` -------------------------------- ### Upgrade Synrepo Setup Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Adopt legacy unowned setup artifacts into the Synrepo ownership ledger. This command helps in migrating older configurations to the current system. ```bash synrepo upgrade --apply ``` -------------------------------- ### Setup Agent Integration Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Initialize Synrepo and set up integrations with various AI tools. This command prepares the repository for agent-assisted workflows. ```bash synrepo setup <tool> ``` -------------------------------- ### Install Synrepo with Semantic Triage Feature Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/EMBEDDINGS.md Install Synrepo from source using Cargo, ensuring the 'semantic-triage' feature is enabled. ```bash cargo install --path . --features semantic-triage ``` -------------------------------- ### Watch and Agent Setup Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Commands for managing the watch service and setting up agent integrations. Supports daemon mode and specific tool configurations. ```bash cargo run -- watch # foreground watch for the current repo cargo run -- watch --daemon # detached per-repo watch service cargo run -- watch status # watch ownership and reconcile telemetry cargo run -- watch stop # stop active watch service or clean stale watch artifacts cargo run -- agent-setup <tool> # write integration shim; automated tier (writes shim + MCP config): claude, codex, open-code, cursor, windsurf, roo; shim-only tier (writes shim only): copilot, generic, gemini, goose, kiro, qwen, junie, tabnine, trae; --regen to update if stale ``` -------------------------------- ### Add Additional Repositories Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Register additional repositories with Synrepo for management. Use this command after the initial setup to include more projects in your registry. ```bash synrepo project add <path> ``` -------------------------------- ### Setup Agent Hooks Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Install local non-blocking nudge hooks for Codex and Claude. These hooks provide subtle prompts and suggestions without interrupting the workflow. ```bash synrepo setup codex --agent-hooks ``` ```bash synrepo setup claude --agent-hooks ``` -------------------------------- ### Local Model Quick Start for Synrepo Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Set up local models like Ollama or llama.cpp for use with Synrepo. Ensure the model server is running and accessible via the specified local endpoint. ```bash ollama serve && ollama pull llama3 ``` ```bash local_endpoint = "http://localhost:8080/v1/chat/completions" ``` -------------------------------- ### Run synrepo mcp Server Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/MCP.md Starts the synrepo mcp stdio server for the current repository. Use flags to specify a different repository, enable overlay writes, or allow source edits. ```bash synrepo mcp # stdio server for the current repo synrepo mcp --repo <path> # stdio server for a specific repo synrepo mcp --allow-overlay-writes # expose overlay note/commentary writes synrepo mcp --allow-source-edits # expose anchored source edit tools synrepo mcp --call-timeout 45s # cap read/resource calls, default 30s ``` -------------------------------- ### Agent Setup for Synrepo Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Writes integration shims for various AI agents. Supports different tiers (automated, shim-only) and regeneration of shims. ```bash cargo run -- agent-setup <tool> # write integration shim; automated tier (writes shim + MCP config): claude, codex, open-code, cursor, windsurf, roo; shim-only tier (writes shim only): copilot, generic, gemini, goose, kiro, qwen, junie, tabnine, trae; --regen to update if stale ``` -------------------------------- ### Run Synrepo Application Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Execute the Synrepo application with '--help' to see command-line options. Run 'cargo run -- mcp' to start the MCP workflow. ```bash cargo run -- --help ``` ```bash cargo run -- mcp ``` -------------------------------- ### Synrepo MCP Edit Workflow Preparation Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/MCP.md Use `synrepo_prepare_edit_context` to set up session-scoped line anchors and compact source context for editing. This is part of the edit-enabled workflow when the server is started with `--allow-source-edits`. ```python synrepo_prepare_edit_context ``` -------------------------------- ### SymbolCard Example Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/FOUNDATION.md Illustrates the structure of a SymbolCard, which provides details about a specific function or symbol within the codebase. This card is compiled from tree-sitter symbols and graph edges. ```text SymbolCard for `parse_query` (function) defined at: src/parser/query.rs:142 signature: pub fn parse_query(input: &str) -> Result<Query, ParseError> doc-comment: "Parse a query string into a typed Query AST..." source body: available at `deep` budget callers/callees: shipped (symbol-to-symbol Calls edges; precision is approximate name resolution, not full type-aware binding) tests touching this symbol: pending dedicated TestSurfaceCard wiring last meaningful change: shipped; uses symbol-level granularity by diffing `body_hash` transitions across the sampled git history. Tracked by `symbol-last-change-v1`. approx tokens: 120 ``` -------------------------------- ### Perform Full Uninstall Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Execute a guided full teardown of Synrepo across projects, integrations, and global state. Review the dry run before passing `--delete-data` to remove data files. ```bash synrepo uninstall ``` -------------------------------- ### Keep Repository Model Fresh Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Starts the synrepo watch process as a daemon to keep the local model updated with file changes. This is necessary for the model to stay synchronized with the actual codebase. ```bash synrepo watch --daemon ``` -------------------------------- ### Agent Query Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Utilize various agent query commands to get information about the repository without opening large files. These commands help in understanding code context and relationships. ```bash synrepo_orient ``` ```bash synrepo_ask ``` ```bash synrepo_find ``` ```bash synrepo_explain ``` ```bash synrepo_impact ``` ```bash synrepo_risks ``` ```bash synrepo_tests ``` ```bash synrepo_changed ``` -------------------------------- ### Graph Traversal in Synrepo Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Performs graph traversal starting from a given node ID and edge kind. ```bash cargo run -- graph query "outbound <node_id> [edge_kind]" # graph traversal ``` -------------------------------- ### Reset Synrepo Explain Totals Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Rotate the explain log and reset accumulated usage totals for Synrepo. This command is useful for managing log size and starting fresh with usage accounting. ```bash synrepo sync --reset-explain-totals ``` -------------------------------- ### Set Up a Repository for an Agent Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Initializes the synrepo environment for a specific agent tool. This command sets up the local model, writes agent instructions, and registers the repository. ```bash cd /path/to/repo synrepo setup claude # or synrepo setup codex ``` -------------------------------- ### Run Synrepo with Default Command Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Executes the bare entrypoint of Synrepo, which probes and routes to the dashboard/setup/repair wizard for TTY, or provides a plain-text summary when piped. ```bash cargo run -- # bare entrypoint: probe + route to dashboard/setup/repair wizard (TTY) or plain-text summary (pipe) ``` -------------------------------- ### Initialize Synrepo Repository Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Commands to initialize a Synrepo repository in the current working directory or at a specified path. ```bash cargo run -- init # initialize .synrepo/ in cwd cargo run -- [--repo <path>] init # override repo root ``` -------------------------------- ### Build and Test Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Standard commands for building the project and running tests. Supports running all tests, specific tests by name or path, and tests for binary crates. ```bash cargo build # build cargo test # run all tests cargo test <test_name> # run a single test (substring match) cargo test -p synrepo <test_name> # run a single test by exact path cargo test --bin synrepo <test_name> # run binary-crate tests (cli_support::tests::*) ``` -------------------------------- ### synrepo_overview Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/FOUNDATION.md Provides initial orientation on an unfamiliar project by returning graph counts. It can also return ModuleCards and EntryPointCards. ```APIDOC ## synrepo_overview(budget?) ### Description Provides initial orientation on an unfamiliar project by returning graph counts. It can also return ModuleCards and EntryPointCards. ### Method Not specified (assumed to be a function call within an SDK or tool) ### Parameters * **budget** (string) - Optional - Specifies the budget tier ('tiny', 'normal', 'deep'). Defaults to 'tiny'. ### Returns Graph counts, ModuleCards, or EntryPointCards. ``` -------------------------------- ### Set Up Repository with Multiple Agents Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Configures synrepo for multiple agent tools in a single command. Use --only to specify agents or --skip to exclude agents. ```bash synrepo setup --only claude,codex synrepo setup --skip goose,kiro ``` -------------------------------- ### Build Synrepo Locally Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Use 'make build' for a standard local development build. Use 'make build-semantic' to include embeddings support. 'make release' creates an optimized build. ```bash make build ``` ```bash make build-semantic # build with embeddings support ``` ```bash make release # optimized build ``` -------------------------------- ### Get Synrepo Status Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Retrieves the operational health of the Synrepo repository, including mode, counts, last reconcile time, lock status, and export freshness. Can output in JSON format. ```bash cargo run -- status [--json] # operational health: mode, counts, last reconcile, lock, export freshness ``` -------------------------------- ### Run synrepo MCP Server Source: https://github.com/whit3rabbit/synrepo/blob/main/src/surface/mcp/README.md These commands demonstrate how to run the synrepo MCP server with different configurations. The server uses stdio for transport. Overlay write and source edit tools are only exposed if the corresponding flags are used. ```bash cargo run -- mcp # stdio server for the current repo ``` ```bash cargo run -- mcp --repo <path> # stdio server for a specific repo ``` ```bash cargo run -- mcp --allow-overlay-writes # expose overlay note/commentary writes ``` ```bash cargo run -- mcp --allow-source-edits # expose anchored source edit tools ``` ```bash cargo run -- mcp --call-timeout 45s # cap read/resource calls, default 30s ``` -------------------------------- ### Set Up Repository with Project-Scoped MCP Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Configures synrepo with project-scoped MCP, allowing agent calls to omit the repository root. This is useful when the repository should manage its own MCP entry. ```bash synrepo setup claude --project ``` -------------------------------- ### Run Lexical Baseline and Hybrid Comparison Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/EMBEDDINGS.md Execute benchmarks to compare lexical and hybrid search modes against task fixtures. This command initiates the benchmarking process. ```bash cargo run -- bench context --tasks 'benches/tasks/*.json' ``` ```bash cargo run --features semantic-triage -- bench search --tasks 'benches/tasks/*.json' --mode both --json ``` -------------------------------- ### synrepo_readiness Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Performs a quick, read-only preflight check of the graph, overlay, index, watch, reconcile, and enabled MCP mutation modes. ```APIDOC ## synrepo_readiness ### Description Performs a quick, read-only preflight check of the graph, overlay, index, watch, reconcile, and enabled MCP mutation modes. ### Method Call ### Endpoint N/A (Function Call) ### Parameters None ``` -------------------------------- ### Enable Explain Feature in Synrepo Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Configure the explain feature by adding an [explain] block to your .synrepo/config.toml file. This enables advisory commentary and cross-link suggestions. ```toml [ explain] enabled = true provider = "anthropic" # or "openai" | "gemini" | "openrouter" | "zai" | "minimax" | "local" # model = "claude-sonnet-4-6" # local_endpoint = "http://localhost:11434/api/chat" ``` -------------------------------- ### Collect Runtime Metrics Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/RUNTIME_BUDGET.md Use these commands to collect various runtime metrics. The `synrepo bench context` command is required for numeric context-savings or context-quality claims. ```bash synrepo status --json synrepo status --recent synrepo bench context --tasks "benches/tasks/*.json" --mode all --json du -sh .synrepo/overlay .synrepo/index/vectors .synrepo/cache/llm-responses ``` -------------------------------- ### Explain and Impact with Budget Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Execute explain, impact, or tests commands with a specified budget for scenarios outside of MCP. This allows for controlled resource usage during analysis. ```bash synrepo explain <target> --budget 1000 ``` ```bash synrepo impact <target> --budget 2000 ``` ```bash synrepo tests <path> --budget 1500 ``` -------------------------------- ### Run Synrepo Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Execute the main Synrepo command to inspect the current repository state. This is the primary command for interacting with Synrepo's core functionality. ```bash synrepo ``` -------------------------------- ### Enable Explain Feature in Synrepo Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/EXPLAIN.md To enable the explain feature, add the following configuration block to your .synrepo/config.toml file. This block allows you to specify the LLM provider and model to use, along with other optional settings. ```toml [explain] enabled = true provider = "anthropic" # "anthropic" | "openai" | "gemini" | "openrouter" | "zai" | "minimax" | "local" | "none" model = "claude-sonnet-4-6" local_endpoint = "http://localhost:11434/api/api/chat" local_preset = "ollama" # informational only; local_endpoint is authoritative commentary_cost_limit = 5000 commentary_concurrency = 4 ``` -------------------------------- ### Export Commentary Docs Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/EXPLAIN.md Writes materialized documentation and updates the explain-doc index. Use --force to rebuild from overlay. ```bash synrepo docs export # write .synrepo/explain-docs/ and update the explain-doc index synrepo docs export --force # rebuild explain-docs and explain-index from overlay ``` -------------------------------- ### Export and Upgrade Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Commands for exporting repository context in various formats and applying storage compatibility upgrades. ```bash cargo run -- export [--format markdown|json] [--deep] [--commit] [--out <dir>] # generate synrepo-context/ cargo run -- upgrade [--apply] # dry-run or apply storage compatibility actions ``` -------------------------------- ### Resume Synrepo Context Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Generates a compact repository resume packet for stale agent work. Can output in JSON format. ```bash cargo run -- resume-context [--json] # compact repo resume packet for stale agent work ``` -------------------------------- ### Synrepo CLI Interaction and Routing Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/MCP.md Interact with Synrepo and route tasks using the CLI. `synrepo ask "review this module"` prompts for a review, and `synrepo task-route "find auth entrypoints"` routes a task. ```bash synrepo ask "review this module" ``` ```bash synrepo task-route "find auth entrypoints" ``` -------------------------------- ### synrepo_entrypoints Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Discovers entrypoints within a given scope, with an optional budget. ```APIDOC ## synrepo_entrypoints ### Description Discovers entrypoints within a given scope, with an optional budget. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **scope** (any) - Optional - The scope for entrypoint discovery. - **budget** (string) - Optional - The budget for entrypoint discovery. ``` -------------------------------- ### synrepo_overview Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Provides a full dashboard view of the graph, readiness status, watch/reconcile operations, explain/commentary features, metrics, and recent activity. ```APIDOC ## synrepo_overview ### Description Provides a full dashboard view of the graph, readiness status, watch/reconcile operations, explain/commentary features, metrics, and recent activity. ### Method Call ### Endpoint N/A (Function Call) ### Parameters None ``` -------------------------------- ### Synrepo CLI Context and Orientation Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/MCP.md Manage Synrepo contexts and orientation using CLI commands. `synrepo resume-context --json` resumes a context in JSON format, and `synrepo orient` reorients the repository. ```bash synrepo resume-context --json ``` ```bash synrepo orient ``` -------------------------------- ### synrepo_lesson_list Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Lists explicit saved repo lessons, supporting filtering by target kind and target. ```APIDOC ## synrepo_lesson_list ### Description Lists explicit saved repo lessons, supporting filtering by target kind and target. Read-only and advisory. Supports optional limit and include_hidden. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **target_kind** (string) - Optional - The kind of target to list lessons for. - **target** (any) - Optional - The specific target to list lessons for. - **limit** (integer) - Optional - The maximum number of lessons to return. - **include_hidden** (boolean) - Optional - Whether to include hidden lessons. ``` -------------------------------- ### Make Commands for CI and Local Checks Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Utility commands using 'make' for local checks, CI linting, and serial testing to ensure consistency and avoid race conditions. ```bash make check # local fmt-check + lint + parallel test make ci-lint # CI lint gate, excludes pre-existing test-only clippy debt make ci-test # CI workspace tests, forced serial to avoid parallel writer-lock flakes make ci-check # CI-equivalent fmt-check + lint + serial workspace test make soak-test # run the ignored mutation-surface soak suite serially ``` -------------------------------- ### Setting Default Project Session Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/SKILL.md Call `synrepo_use_project` once to set the default project for the session when in a global or defaultless context. ```python synrepo_use_project(repo_root) ``` -------------------------------- ### Run Synrepo Dashboard Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Inspect the current repository state using the Synrepo dashboard. This command is useful for a visual overview of your project's status. ```bash synrepo dashboard ``` -------------------------------- ### Saving Repo-Specific Lessons Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Commands to save and recall local coding facts without promoting them to global truth. ```bash synrepo remember "MCP note writes are overlay-only" --target docs/MCP.md --ttl 30d synrepo recall "overlay-only" synrepo lessons ``` -------------------------------- ### Synrepo Storage Layout Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/SCHEMA.md Overview of the directory structure and key files within the .synrepo/ directory and user-wide registry. ```text .synrepo/ graph/nodes.db canonical graph (SQLite) overlay/overlay.db overlay store (SQLite, separate database) index/ syntext-backed lexical index (binary) index/vectors/ flat-vec embedding index (binary, optional) cache/llm-responses/ disposable LLM response cache state/ ephemeral JSON / JSONL state files config.toml operator config (see docs/CONFIG.md) explain-docs/ advisory commentary docs and discovery files explain-index/ syntext index over explain-docs (advisory) ~/.synrepo/projects.toml user-wide install registry ``` -------------------------------- ### Plan Removal of Synrepo Artifacts Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Plan the removal of Synrepo-owned artifacts from the current repository without uninstalling the binary. Use `--apply` to execute the removal plan. ```bash synrepo remove ``` ```bash synrepo remove --apply ``` -------------------------------- ### synrepo_ask Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md The default high-level front door for a bounded, cited task-context packet. It supports optional scope, shape, ground, and budget parameters. ```APIDOC ## synrepo_ask ### Description The default high-level front door for a bounded, cited task-context packet. It supports optional scope, shape, ground, and budget parameters. Empty-scope asks promote high-confidence lexical hits to concrete file artifacts before broad search artifacts. Use exact search after it when the packet is insufficient or the task names literal identifiers. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **ask** (any) - Required - The task-context packet. - **scope** (any) - Optional - The scope for the ask. - **shape** (any) - Optional - The shape of the response. - **ground** (any) - Optional - Grounding information for the ask. - **budget** (any) - Optional - Budget for the ask. ``` -------------------------------- ### Manual Health and Repair Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Use `synrepo check` and `synrepo sync` for manual attention to repository health or repair needs. These commands are for situations requiring direct intervention. ```bash synrepo check ``` ```bash synrepo sync ``` -------------------------------- ### synrepo_resume_context Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Generates an advisory repo-scoped resume packet for stale work, assembled from existing repo state. ```APIDOC ## synrepo_resume_context ### Description Generates an advisory repo-scoped resume packet for stale work, assembled from existing repo state without prompt logs, chat history, or raw tool-output capture. Supports optional limit, since_days, budget_tokens, and include_notes. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **limit** (integer) - Optional - The limit for the resume context. - **since_days** (integer) - Optional - The number of days to look back for context. - **budget_tokens** (integer) - Optional - The budget for the resume context in tokens. - **include_notes** (boolean) - Optional - Whether to include notes. ``` -------------------------------- ### Repository Drift and Sync Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Commands for checking repository drift and synchronizing data. Supports JSON output for machine readability. ```bash cargo run -- check # read-only drift report: surfaces, severities, recommended actions cargo run -- check --json # machine-readable JSON drift report cargo run -- sync # repair auto-fixable drift surfaces; appends to .synrepo/state/repair-log.jsonl cargo run -- sync --json # JSON sync summary ``` -------------------------------- ### synrepo_entrypoints Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/FOUNDATION.md Identifies the entry points for execution within a specified scope. ```APIDOC ## synrepo_entrypoints(scope?, budget?) ### Description Identifies the entry points for execution within a specified scope. ### Method Not specified (assumed to be a function call within an SDK or tool) ### Parameters * **scope** (string) - Optional - The scope within which to find entry points. * **budget** (string) - Optional - Specifies the budget tier ('tiny', 'normal', 'deep'). Defaults to 'tiny'. ### Returns EntryPointCards for the scope. ``` -------------------------------- ### synrepo_minimum_context Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/FOUNDATION.md Determines the smallest set of files required to perform a given task, returning a ranked list of FileCards within the specified budget. ```APIDOC ## synrepo_minimum_context(task_description, budget?) ### Description Determines the smallest set of files required to perform a given task, returning a ranked list of FileCards within the specified budget. ### Method Not specified (assumed to be a function call within an SDK or tool) ### Parameters * **task_description** (string) - Required - A description of the task for which to find the minimum context. * **budget** (string) - Optional - Specifies the budget tier ('tiny', 'normal', 'deep'). Defaults to 'tiny'. ### Returns Budget-capped ranked FileCards. ``` -------------------------------- ### Benchmark Context Savings Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Run benchmarks to gather evidence for context-savings claims. This command includes various tasks to evaluate different aspects of context handling. ```bash synrepo bench context --tasks "benches/tasks/*.json" --mode all --json ``` -------------------------------- ### synrepo_next_actions Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/FOUNDATION.md Provides a prioritized list of derived handoffs from the repair log, overlay, and git hotspots. ```APIDOC ## synrepo_next_actions(limit?, since_days?) ### Description Provides a prioritized list of derived handoffs from the repair log, overlay, and git hotspots. ### Method Not specified (assumed to be a function call within an SDK or tool) ### Parameters * **limit** (integer) - Optional - The maximum number of actions to return. * **since_days** (integer) - Optional - Filters actions to those from the last specified number of days. ### Returns A prioritized task list. ``` -------------------------------- ### Enable Tracing Output Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Enables detailed tracing output for Synrepo commands by setting the RUST_LOG environment variable. ```bash RUST_LOG=debug cargo run -- <cmd> # enable tracing output ``` -------------------------------- ### synrepo_use_project Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Sets the default repository for a global/defaultless MCP session. ```APIDOC ## synrepo_use_project ### Description Sets the default repository for a global/defaultless MCP session. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **repo_root** (string) - Required - The root path of the repository. ``` -------------------------------- ### synrepo_lesson_search Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Searches explicit saved repo lessons, supporting filtering by target kind and target. ```APIDOC ## synrepo_lesson_search ### Description Searches explicit saved repo lessons, supporting filtering by target kind and target. Read-only and advisory. Supports optional limit and include_hidden. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **query** (string) - Required - The search query for lessons. - **target_kind** (string) - Optional - The kind of target to search within. - **target** (any) - Optional - The specific target to search within. - **limit** (integer) - Optional - The maximum number of results to return. - **include_hidden** (boolean) - Optional - Whether to include hidden lessons. ``` -------------------------------- ### Compile Windows-only Code Locally Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md When adding or touching `cfg(windows)` code, run `cargo clippy --target x86_64-pc-windows-gnu --bins --lib -- -D warnings` locally before pushing to ensure Windows-only lints are caught. ```bash cargo clippy --target x86_64-pc-windows-gnu --bins --lib -- -D warnings ``` -------------------------------- ### CI Specific Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Commands tailored for Continuous Integration environments, including linting, testing, and checking. ```bash make ci-lint # CI lint gate, excludes pre-existing test-only clippy debt make ci-test # CI workspace tests, forced serial to avoid parallel writer-lock flakes make ci-check # CI-equivalent fmt-check + lint + serial workspace test ``` -------------------------------- ### Run Mutation Soak Test (Unix-only) Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md This ignored Unix-only release-gate suite covers crash recovery and mutation blocking. Run it serially with `cargo test --test mutation_soak -- --ignored --test-threads=1` or `make soak-test`. ```bash cargo test --test mutation_soak -- --ignored --test-threads=1 ``` ```bash make soak-test ``` -------------------------------- ### Benchmark Search Performance Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Compares lexical and hybrid search performance at a hit rate of 5, using specified task files and modes. Outputs results in JSON. ```bash cargo run -- bench search --tasks 'benches/tasks/*.json' --mode both --json # compare lexical vs hybrid search hit@5 ``` -------------------------------- ### Runtime Compatibility Snapshot Structure Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/SCHEMA.md Represents the structure of a runtime compatibility snapshot, used to track store format versions and configuration fingerprints. This helps in evaluating compatibility between the binary and the stored data. ```text RuntimeCompatibilitySnapshot { snapshot_version: u32, store_format_versions: BTreeMap<String, u32>, config_fingerprints: ConfigFingerprints { index_inputs: String, graph_inputs: String, history_inputs: String, advisory_inputs: String, }, } ``` -------------------------------- ### Format and Check Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Commands for formatting code and performing local checks including formatting, linting, and parallel testing. ```bash cargo fmt # format make check # local fmt-check + lint + parallel test ``` -------------------------------- ### synrepo_minimum_context Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Provides a bounded neighborhood context step before deep inspection or full-file reads. Accepts a target and an optional budget. ```APIDOC ## synrepo_minimum_context ### Description Provides a bounded neighborhood context step before deep inspection or full-file reads. Accepts a target and an optional budget. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **target** (any) - Required - The target for context retrieval. - **budget** (string) - Optional - The budget for context retrieval. ``` -------------------------------- ### Benchmarking Search Performance Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Compare lexical and hybrid search performance before enabling embeddings. ```bash synrepo bench search --tasks 'benches/tasks/*.json' --mode both --json ``` -------------------------------- ### List and Search Commentary Docs Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/EXPLAIN.md Lists materialized docs with freshness information or searches them using a query. ```bash synrepo docs list # list materialized docs and freshness synrepo docs search <query> # search materialized commentary docs ``` -------------------------------- ### Run Synrepo MCP Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Launch Synrepo's MCP (Managed Code Processing) flow. This command is used when integrating with tools that support MCP. ```bash synrepo mcp --repo . ``` -------------------------------- ### Branch-Ref Status Check Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/SKILL.md Use `synrepo_readiness` to check branch-ref status, including configured read-only refs, local resolution, and monitoring status. ```python synrepo_readiness() ``` -------------------------------- ### Upgrade Synrepo Storage Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Performs a dry-run or applies storage compatibility actions for Synrepo. ```bash cargo run -- upgrade [--apply] # dry-run or apply storage compatibility actions ``` -------------------------------- ### General Query Routing with Synrepo Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/SKILL.md Use `synrepo_ask`, `synrepo_task_route`, `synrepo_find`, or `synrepo_where_to_edit` for broader search and editing tasks. `synrepo_ask` accepts structured objects or shorthand for scope, shape, and ground. ```python synrepo_ask(ask, scope?, shape?, ground?, budget?) ``` ```python synrepo_task_route(task, path?) ``` ```python synrepo_find(task, limit?, budget_tokens?) ``` ```python synrepo_where_to_edit(task, limit?) ``` ```python synrepo_ask(ask, scope="path/to/file", shape="findings; tests", ground="observed graph/source only", budget="normal") ``` -------------------------------- ### Synrepo CLI Search and Node Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/MCP.md Perform searches and inspect nodes using the Synrepo CLI. `synrepo search "term"` searches for a term, and `synrepo node <target>` displays information about a specific node. ```bash synrepo search "term" ``` ```bash synrepo node <target> ``` -------------------------------- ### Bootstrap Function Signature Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md The `synrepo::bootstrap::bootstrap` function accepts two arguments: `repo_root: &Path` and `mode: Option<Mode>`. It derives `Config` and `synrepo_dir` internally. ```rust synrepo::bootstrap::bootstrap(repo_root: &Path, mode: Option<Mode>) ``` -------------------------------- ### CI Lint Gate Command Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Runs the CI lint gate for product targets, with warnings disabled. This command checks the codebase for linting issues. ```bash cargo clippy --workspace --bins --lib -- -D warnings # CI lint gate (product targets) ``` -------------------------------- ### synrepo_explain Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Workflow alias for bounded card lookup, useful for workflow alias for bounded card lookup, useful for reviewing, refactoring, security passes, or unfamiliar subsystem changes. ```APIDOC ## synrepo_explain ### Description Workflow alias for bounded card lookup, useful for reviewing, refactoring, security passes, or unfamiliar subsystem changes. Use `budget=deep` for 1-3 focal targets when existing overlay commentary would help a review, refactor, security pass, or unfamiliar subsystem change; this does not refresh commentary. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **target** (any) - Required - The target for explanation. - **budget** (string) - Optional - The budget for the explanation (e.g., "deep"). - **budget_tokens** (integer) - Optional - The budget for the explanation in tokens. ``` -------------------------------- ### Map Definition Query Patterns to Symbol Kinds Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/ADDING-LANGUAGE.md Create a static slice mapping each pattern in the definition query to a `SymbolKind`. The length of this slice must equal the definition query's `pattern_count()`. ```rust const <LANG>_KIND_MAP: &'static [SymbolKind] = &[ // ... ]; ``` -------------------------------- ### synrepo_task_route Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/FOUNDATION.md Classifies a given task into the cheapest safe route, providing details about the intent, confidence, recommended tools, budget tier, and signals. ```APIDOC ## synrepo_task_route(task, path?) ### Description Classifies a given task into the cheapest safe route, providing details about the intent, confidence, recommended tools, budget tier, and signals. ### Method Not specified (assumed to be a function call within an SDK or tool) ### Parameters * **task** (string) - Required - The description of the task to classify. * **path** (string) - Optional - The path associated with the task. ### Returns Intent, confidence, recommended tools, budget tier, and signals. ``` -------------------------------- ### Regenerate Skill or Instructions Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Generate or regenerate the skill or instructions file for an agent without running the full onboarding flow. This is useful for updating agent configurations. ```bash synrepo agent-setup <tool> ``` -------------------------------- ### Core Operational Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Primary commands for interacting with the Synrepo repository, including initialization, reconciliation, and embedding building. ```bash cargo run -- # bare entrypoint: probe + route to dashboard/setup/repair wizard (TTY) or plain-text summary (pipe) cargo run -- init # initialize .synrepo/ in cwd cargo run -- [--repo <path>] init # override repo root cargo run -- reconcile # refresh graph store without full re-bootstrap cargo run -- embeddings build # build/rebuild optional semantic vector index ``` -------------------------------- ### Run Mutation Soak Test Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Executes the ignored mutation-surface soak suite serially. ```bash make soak-test # run the ignored mutation-surface soak suite serially ``` -------------------------------- ### Create Test AppState with TempDir Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Use `make_ready_poll_state()` for TUI tests that require `Config::load` or on-disk reads from `AppState`. It returns `(TempDir, AppState)` after running `bootstrap()`. ```rust make_ready_poll_state() ``` -------------------------------- ### synrepo_minimum_context Source: https://github.com/whit3rabbit/synrepo/blob/main/openspec/specs/mcp-surface/spec.md Exposes a tool to retrieve a budget-bounded 1-hop neighborhood around a focal symbol or file. It returns information about the focal card, neighboring summaries or cards, governing decisions, and co-change partners. ```APIDOC ## synrepo_minimum_context(target, budget?) ### Description Returns a budget-bounded 1-hop neighborhood around a focal symbol or file. The response follows the minimum-context spec contract, including the focal card, structural neighbor summaries or full cards (depending on budget), governing decisions, and co-change partners. ### Parameters #### Path Parameters None #### Query Parameters - **target** (string) - Required. The node ID or qualified path of the focal symbol or file. - **budget** (string) - Optional. The budget for the neighborhood analysis. Accepts \"tiny\", \"normal\" (default), or \"deep\". ### Request Example ```json { "tool_code": "synrepo_minimum_context", "arguments": { "target": "synrepo://project/proj_1234/file/src/lib.rs", "budget": "normal" } } ``` ### Response #### Success Response (200) - **focal_card** (object) - Information about the focal symbol or file. - **neighbors** (array) - Summaries or full cards of structural neighbors, depending on the budget. - **governing_decisions** (array) - Decisions governing the context. - **co_change_partners** (array) - Partners that co-change with the focal item. #### Response Example ```json { "focal_card": { "id": "synrepo://project/proj_1234/file/src/lib.rs", "type": "file", "language": "rust" }, "neighbors": [ { "id": "synrepo://project/proj_1234/file/src/main.rs", "type": "file", "summary": "Contains the main application entry point." } ], "governing_decisions": [], "co_change_partners": [] } ``` ``` -------------------------------- ### Context Pack for Agent Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Use `synrepo_context_pack` when the agent requires multiple read-only code artifacts or task-context pieces in a single response. This helps in consolidating information for the agent. ```bash synrepo_context_pack ``` -------------------------------- ### Run Parallel Workspace Checks Locally Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Use 'make check' for faster parallel workspace checks locally. Confirm any suspicious failures with a focused rerun or 'make ci-test'. ```shell make check ``` -------------------------------- ### synrepo_docs_search Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Performs an advisory search over existing materialized explain docs for architecture, intent, gotchas, and "why" questions. ```APIDOC ## synrepo_docs_search ### Description Performs an advisory search over existing materialized explain docs for architecture, intent, gotchas, and "why" questions. This does not refresh commentary. Supports optional limit. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **query** (string) - Required - The search query. - **limit** (integer) - Optional - The maximum number of results to return. ``` -------------------------------- ### Error when accepting cross-link in auto mode Source: https://github.com/whit3rabbit/synrepo/blob/main/openspec/specs/overlay-links/spec.md This command fails with an explicit error when invoked in auto mode, as promotion is restricted to curated mode only. No graph write is attempted. ```bash synrepo links accept ``` -------------------------------- ### Define Tree-sitter Query for Definitions Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/ADDING-LANGUAGE.md For each new language, define a static string constant for the tree-sitter query used to capture code definitions. This query must expose `@item` and `@name` captures. ```rust const <LANG>_DEFINITION_QUERY: &str = r#" … "#; ``` -------------------------------- ### Synrepo CLI Graph Query and View Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/MCP.md Query and view graph data using the Synrepo CLI. `synrepo graph query "inbound <target>"` and `synrepo graph query "outbound <target>"` query graph relationships. `synrepo graph view <target> --json` views graph data in JSON, while `synrepo graph view <target>` provides a TTY-only explorer. ```bash synrepo graph query "inbound <target>" ``` ```bash synrepo graph query "outbound <target>" ``` ```bash synrepo graph view <target> --json ``` ```bash synrepo graph view <target> # TTY-only terminal explorer ``` -------------------------------- ### Export Synrepo Context Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Generates the synrepo-context directory. Supports exporting in markdown or JSON format, deep export, committing changes, and specifying an output directory. ```bash cargo run -- export [--format markdown|json] [--deep] [--commit] [--out <dir>] # generate synrepo-context/ ``` -------------------------------- ### Synrepo Storage Layout Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/FOUNDATION.md The .synrepo directory contains configuration, index, graph, overlay, and cache data. The graph store holds nodes and edges, while the overlay store manages commentary and audit rows. Optional semantic index vectors are stored separately. ```directory .synrepo/ config.toml .gitignore index/ graph/ nodes.db overlay/ overlay.db index/vectors/ cache/ state/ reconcile-state.json repair-log.jsonl storage-compat.json writer.lock writer.lock.flock watch-daemon.json watch-daemon.json.flock ``` -------------------------------- ### synrepo_task_route Source: https://github.com/whit3rabbit/synrepo/blob/main/skill/references/mcp-tools.md Classifies a task into the cheapest safe route and stable hook signals. ```APIDOC ## synrepo_task_route ### Description Classifies a task into the cheapest safe route and stable hook signals. ### Method Call ### Endpoint N/A (Function Call) ### Parameters - **task** (string) - Required - The task to classify. - **path** (string) - Optional - The path associated with the task. ``` -------------------------------- ### Add Tree-sitter Crate to Cargo.toml Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/ADDING-LANGUAGE.md To add support for a new language, you must first add its corresponding tree-sitter grammar crate to your `Cargo.toml` file. Ensure you follow the versioning style of existing entries. ```toml tree-sitter-<lang> = "<version>" ``` -------------------------------- ### synrepo_minimum_context Source: https://github.com/whit3rabbit/synrepo/blob/main/openspec/specs/mcp-surface/spec.md Returns a budget-bounded neighborhood for a focal node. This tool is part of the task-first tools and provides structural neighbor summaries and top-3 co-change partners. ```APIDOC ## synrepo_minimum_context(node, budget?) ### Description Returns a budget-bounded neighborhood for a focal node. It provides structural neighbor summaries and top-3 co-change partners, using a default budget if none is specified. ### Method Not specified (assumed to be an MCP tool invocation) ### Endpoint Not specified (MCP tool interface) ### Parameters #### Path Parameters None #### Query Parameters None #### Request Body - **node** (string) - Required - The focal node for which to retrieve the neighborhood. - **budget** (string) - Optional - The budget for the neighborhood retrieval, can be `normal`. Defaults to `normal`. ### Request Example ```json { "tool_name": "synrepo_minimum_context", "parameters": { "node": "com.example.MyClass" } } ``` ### Response #### Success Response (200) - **MinimumContextCard** - A card containing structural neighbor summaries and top-3 co-change partners. #### Response Example ```json { "card_type": "MinimumContextCard", "node": "com.example.MyClass", "neighbors": [ "com.example.AnotherClass", "com.example.Helper" ], "co_change_partners": [ "com.example.ModuleA", "com.example.ModuleB", "com.example.ModuleC" ] } ``` ``` -------------------------------- ### Sync Synrepo Repository Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Repairs auto-fixable drift surfaces and appends to the repair log. Can output a JSON summary of the sync operation. ```bash cargo run -- sync # repair auto-fixable drift surfaces; appends to .synrepo/state/repair-log.jsonl cargo run -- sync --json # JSON sync summary ``` -------------------------------- ### Validate Synrepo Code Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Run 'make check' for general checks. Use 'cargo test' for unit tests. 'cargo clippy -- -D warnings' checks for lints with warnings as errors. 'cargo fmt --check' verifies code formatting. ```bash make check ``` ```bash cargo test ``` ```bash cargo clippy -- -D warnings ``` ```bash cargo fmt --check ``` -------------------------------- ### Reconcile Synrepo Repository Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md Refreshes the graph store without performing a full re-bootstrap. ```bash cargo run -- reconcile # refresh graph store without full re-bootstrap ``` -------------------------------- ### Linting and Formatting Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Commands for maintaining code quality through linting and formatting checks. ```bash cargo clippy --workspace --bins --lib -- -D warnings # CI lint gate (product targets) cargo fmt # format ``` -------------------------------- ### Status and Routing Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Commands to check operational status, route tasks, and retrieve context information. JSON output is available for status and routing. ```bash cargo run -- status [--json] # operational health: mode, counts, last reconcile, lock, export freshness cargo run -- task-route <task> [--path <path>] [--json] # read-only fast-path route classifier cargo run -- resume-context [--json] # compact repo resume packet for stale agent work ``` -------------------------------- ### Accepting a cross-link in curated mode Source: https://github.com/whit3rabbit/synrepo/blob/main/openspec/specs/overlay-links/spec.md Use this command to promote a reviewed cross-link to the graph when operating in curated mode. This action records the promotion with reviewer identity and updates the candidate row. ```bash synrepo links accept <id> ``` -------------------------------- ### Graph and Node Inspection Commands Source: https://github.com/whit3rabbit/synrepo/blob/main/AGENTS.md Commands for querying and inspecting the repository's graph structure, including traversals and node metadata. ```bash cargo run -- graph query "outbound <node_id> [edge_kind]" # graph traversal cargo run -- graph stats # node/edge counts cargo run -- node <node_id> # dump a node's metadata as JSON ``` -------------------------------- ### SQLite PRAGMAs for Graph Store Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/SCHEMA.md Configuration pragmas applied to the SQLite graph database, affecting journaling, synchronization, foreign keys, and busy timeouts. ```sql journal_mode = WAL synchronous = NORMAL foreign_keys = ON busy_timeout = 5000 ``` -------------------------------- ### Run Workspace Lints Source: https://github.com/whit3rabbit/synrepo/blob/main/CLAUDE.md CI linting runs `cargo clippy --workspace --bins --lib -- -D warnings`. `--all-targets` is not used to avoid test-only lints. ```bash make ci-lint ``` -------------------------------- ### Building Embeddings Source: https://github.com/whit3rabbit/synrepo/blob/main/README.md Command to build the vector index when synrepo is built with the 'semantic-triage' feature. ```bash synrepo embeddings build ``` -------------------------------- ### Implement Signature Extraction (Optional) Source: https://github.com/whit3rabbit/synrepo/blob/main/docs/ADDING-LANGUAGE.md If signature extraction is desired, add a match arm for the new language variant in `extract_signature` within `src/structure/parse/extract/docs.rs`. ```rust extract_signature ```
