Grepticon Docs
The hosted read-only filesystem for AI agents — ls, find, cat, grep over isolated, permissioned workspaces.
Grepticon is a hosted, read-only filesystem for AI agents. You push files into
isolated, permissioned workspaces, and your agents retrieve from them with four
familiar tools — ls, find, cat, and grep (plus a semantic cut) —
instead of an embedding index. There is no sandbox to boot and no embeddings to
maintain: retrieval is just navigating a directory tree the same way a developer
would.
Start here
Quickstart
Sign up, create a key, push files, mint a token, and run an AI-SDK agent against api.grepticon.com — in one sitting.
Concepts
Workspaces, the virtual filesystem, async ingestion, and read sessions — the nouns the rest of the docs assume.
API Reference
The generated REST surface for /v1 — workspaces, files, read, tokens, and audit.
SDK Reference
The @grepticon/sdk client — GrepticonClient, the AI-SDK adapter, and the error model.
Go deeper
- Authentication — the two credential planes
(
grp_sk_management keys andgrp_at_read-only tokens). - Access control — scope what an agent sees with the claims × visibility ACL.
- Tools — how
ls/find/cat/grepbehave and the semanticcut. - Limits — rate limits and plan quotas.
- Support — how to get help.