Documentation
AI agents
Install the Agent Skill so that coding agents can find, read and request data through the CLI.
QuantLake comes with an Agent Skill that teaches coding agents, such as Claude Code and Codex, how to use the lake.
Install the skill
npx skills@latest add supermomonga/quantlake --globalAlternatively, copy the skills/quantlake folder of the repository into your agent's skills folder, for example ~/.claude/skills/.
What an agent can do
With the skill installed, an agent can answer questions such as "Which files do I need to read BTCUSDT trades for October in DuckDB?". The skill tells it to:
- Check what is saved with
quantlake saved --json. - Get the file paths and the wildcard pattern with
quantlake files --json. - Read the files with DuckDB or Polars, filtering on the
datecolumn. - If the data is missing, check what the plan includes with
quantlake availableand register a target withquantlake targets add.
It can also delete data and ask for downloads to be repeated, all through the CLI. See JSON output for the fields that agents read.
What agents cannot do
Agents cannot edit the data files directly. Any write to the lake fails with Operation not permitted. A note in the lake folder (AGENTS.md) and the skill both explain why, and tell the agent which command to use instead.
The skill also tells agents:
- not to unlock the files with
chattrorsudo, and not to editmetadata.db; - not to read or decrypt secrets, and to leave setting API keys to you;
- not to change the Databento budget. If paid data is needed, the agent reports the
over_budgetdays and leaves the decision to you; - to check free disk space before registering large order book downloads.