An affordable, secure research agent loop on your own machine. One loopback-only Rust service researches with a local model: goal loops, evidence-checked web research, browser tasks on sites you name, and memory for the findings. Cloud calls are optional and priced first; every read obeys your URL rules.
60-second demo · Quick start · Research loop · Invariants · Documentation
| Capability | What it provides | Fresh-home state |
|---|---|---|
| Web research | Search, permitted reads and crawls, /web research jobs with checked quotes, local PDF text. |
On; allowlist with one seeded Google rule. |
| Goal loops | /goal and /loop continue after the tab closes. |
50 turns, 200,000 tokens, two failed turns; local only. |
| Memory | Pinned and uploaded notes, account-private facts. | On; proposals need review. |
| Local chat | Sessions, transcript search and export, text, DOCX and PDF attachments, skills, styles. | Ollama on loopback. |
| Browser tasks | /browse <site> <task>: the local model drives sandboxed Chrome on those sites only. Block rules cover every request and redirect; password fields and non-GET/HEAD requests are held. |
On for administrators; setup. |
| Analytics, diagnostics | Token and run history, Estimate draft, /diag redacted logs. |
On; /diag admin or auditor. |
| Cloud chat | Optional Grok or Claude; only the new message leaves. | Needs a key. |
| Off by default | Reviewed coding in isolated clones, MCP tools and memory gateway, Netconnect LAN observation, Firecrawl fallback reads, completion webhooks. Native computer use: closed gate only (#996). | Each needs configuration. |
Code decides permission, budget and deadlines; the model chooses searches, pages and conclusions.
flowchart TD
A[Goal turn with local context] --> B{Goal web mode}
B -->|off, or notes answered it| C[Answer locally; name gaps]
B -->|fetch or all| D{Checked evidence held for this run?}
D -->|yes: hash, age, permission recheck| H
D -->|no| E{Outside evidence needed?}
E -->|no| C
E -->|all| F[One query: tavily → serpapi → google-public, one deadline]
F --> G[Model picks pages; listings grant admin-turn reads]
E -->|fetch: URL known| G
G --> I[Exact permitted read; cache unless refresh]
I -->|blocked, script shell or unusable PDF, if opted in| J[Firecrawl re-reads the same URL]
I --> H[Up to 3 BM25 passages per page, receipt IDs]
J --> H
H --> K[Digest ≤ 1,024 tokens; quotes and IDs validated]
K --> L[Continue reasoning; references survive compaction]
L --> A
all is the shipped goal web mode. The digest proves provenance, not logical support; GOAL_DONE stays model advice. Open: #772.
Contracts live in INVARIANTS.md; the guard fails cargo test when one breaks.
- Loopback only. Non-loopback binds are refused; fresh homes need HTTPS and login.
- Process isolation (I6). The coding pipeline runs only as a
cgagentharness agentic …child behind an allowlisted shim; browser tasks run in a child with no provider keys. - Writes are gated. Write gates ship false; approval, push and publication each need a reason and confirmation; a revoked gate stops a run at its next iteration; checks run under Seatbelt or bubblewrap.
- Web needs current permission. Reads are DNS-pinned to public addresses; policy and sign-ins are rechecked after waits and before dispatch, storage and delivery. Replies render as text, so an injected Markdown image fetches nothing.
- Strict config. Gates need literal YAML
true; malformed numbers stop startup. - Secrets stay out. Keys live in the OS credential store, never in responses, logs or model context.
- No telemetry. Both
deny.tomlfiles ban telemetry crates; CI runscargo deny, a telemetry contract check and daily advisory checks.
Accounts are not tenants (shared state).
A home is ~/.CGagentHarness (CGAGENTHARNESS_HOME); run one app or server per home. macOS from scratch: scripts/install-macos.sh, then scripts/start-macos.sh (automated install).
Any OpenAI-compatible loopback service works; the default qwen3.8:27b-mlx-cg is a locally derived tag. Budgets assume a 32,768-token window and the harness sends no num_ctx:
OLLAMA_CONTEXT_LENGTH=32768 ollama servemacOS app: from Releases, download the zip and SHA256SUMS:
shasum -a 256 -c SHA256SUMS
unzip CG-Agent-Harness-macos-universal.zip
open "CG Agent Harness.app"The app is ad-hoc signed (Gatekeeper). Standalone server, macOS or Linux (Rust 1.89, C compiler; Install):
git clone https://github.com/cgfixit/CG-agent-harness.git
cd CG-agent-harness
cargo build --release --locked
./target/release/cgagentharness serveOpen https://127.0.0.1:8790/, trusting the local certificate.
- Set your password with the setup code (app: Setup and recovery; terminal:
<home>/setup-code) and 12+ characters. /model list,/model use <tag>,/help./web allow https://example.org/*, then/web research <question>; for a longer piece,/goal <question>and/loop 3.- Browser tasks: install Google Chrome, run
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 npm ciinbrowser/, then/browse docs.python.org what does zipfile.Path do?.
CLI (--help each): serve, account, web, tls, mcp-key, netconnect. Console: slash reference.
First launch seeds config.yaml from the defaults; edit it and restart, or use Reload limits (reloadable). Contributors: AGENTS.md. Windows has CI but no release.
docs/README.md indexes every guide.
| Topic | Guide |
|---|---|
| Setup, models, recovery, pins | Install, Models, Troubleshooting, Dependencies |
| Chat, loops, memory | Console, Memory |
| Research, browser tasks | Web decision router, Secure research, Browser use, Security |
| Coding, MCP, desktop, routes | Coding pipeline, MCP, Desktop, Routes |
MIT.
