ContextSutra AI

11. FAQ and glossary

FAQ

Does it need an API key or internet? No. It runs offline and never calls a model.

Does it send my code anywhere? No. It reads files you point it at and writes files you name. The optional server binds to loopback only.

Is it safe to share a capsule? It reduces risk but cannot promise safety. Read the report first; regex redaction is best effort.

Does it work with Cursor, Claude Code, Codex, Gemini CLI and Copilot? It writes skills to each tool's documented project directory and renders a Markdown hand-off any tool can read. Whether a given tool loads the skills has not been tested; the matrix says so.

How is this different from an AGENTS.md or CLAUDE.md file? Those are hand-written instructions. A capsule is generated from your repository, carries hashes and line references, can be checked for staleness, and separates observed facts from assumptions.

Why not just paste the README? You get no freshness check, no redaction, no quarantine of planted instructions and no record of what was shared.

Can it read my AI chat history or IDE memory? No, by design.

Does it understand my code? No. It captures documentation, decisions, tasks and manifest metadata. It does not parse source code bodies.

Is the digest a signature? No. It is a checksum. See Security and legal.

Can I use it commercially? Yes, under Apache-2.0. Keep the notices.

Where is the proof it works? evidence/README.md and the audit report.

Glossary

TermMeaning
CapsuleJSON file of captured sources, hashes and metadata
SourceOne captured document with a SHA-256 hash
DigestSHA-256 of the canonical capsule; a checksum
RedactionReplacing a secret-looking line with a placeholder
QuarantineWithholding an instruction-like line; only its number is kept
DriftDifference between capsule and repository now
GateThe review verdict: BLOCK or HUMAN_REVIEW_REQUIRED
ADRArchitecture decision record
HostThe AI tool that will read the context
SkillA SKILL.md instruction file for an AI assistant
Untrusted dataText from the repository, treated as quotes, never as commands