`agent`

Scan repository context and ask a local model for feedback.

AccessReads repo and sends selected context

NetworkLocal Ollama by default

SourceBuilt-in Clyde command

Clyde agent command scanning repository context and requesting local model feedback — Agent scans bounded repository context, sends selected chunks to the configured local model, and returns actionable repository feedback.

Syntax#

clyde agent REPO [scan flags] [--model MODEL] [--ollama-url URL] [--max-context-chars N] [--allow-remote-ollama] [PROMPT]

Options#

Flag	Purpose
`--model`	Ollama model name.
`--ollama-url`	Ollama base URL.
`--timeout`	Seconds to wait for Ollama.
`--max-context-chars`	Maximum repository context characters to send.
`--num-ctx`	Ollama context window tokens; 0 uses model default.
`--no-stream`	Wait for full response before printing.
`--prompt-file`	Read feedback prompt from file.
`--stdin`	Read feedback prompt from stdin.
`--allow-remote-ollama`	Allow sending scanned source context to a non-local Ollama URL.
`--include`	Only include matching globs; repeatable.
`--exclude`	Skip matching globs in addition to defaults; repeatable.
`--max-file-bytes`	Skip files larger than this many bytes.
`--max-chunk-chars`	Split source text at this many characters.

Arguments#

REPO
PROMPT

Examples#

clyde agent . "Review this repository for missing tests"

clyde agent . --include "internal/**/*.go" --prompt-file review.md

cat review.md | clyde agent . --stdin

Example Use Cases#

Build a bounded repository prompt from scanned chunks. Agent refuses non-local Ollama URLs unless --allow-remote-ollama is explicit.

Safety Notes#

Clyde is a local workflow harness, not an operating-system sandbox. Review bundles before upload, keep NotebookLM notebooks private, and avoid sending secrets, customer data, production records, tokens, credentials, browser state, or private keys.