Grepticon Docs
A hosted read-only filesystem for AI agents, with ls, find, cat, and grep over isolated 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 instead of an embedding index: ls, find, cat, and grep.
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 why there's no semantic search. - Limits: rate limits and plan quotas.
- Support: how to get help.