btca CLI btca is a source-first research CLI. It hydrates resources (git, local, npm) into searchable context, then answers questions grounded in those sources. Use configured resources for ongoing work, or one-off anonymous resources directly in btca ask . Full CLI reference: https://docs.btca.dev/guides/cli-reference Add resources:
Git resource
btca add -n svelte-dev https://github.com/sveltejs/svelte.dev
Local directory
btca add -n my-docs -t local /absolute/path/to/docs
npm package
btca add npm:@types/node@22.10.1 -n node-types -t npm Verify resources: btca resources Ask a question: btca ask -r svelte-dev -q "How do I define remote functions?" Common Tasks Ask with multiple resources: btca ask -r react -r typescript -q "How do I type useState?" Ask with anonymous one-off resources (not saved to config):
One-off git repo
btca ask -r https://github.com/sveltejs/svelte -q "Where is the implementation of writable stores?"
One-off npm package
btca ask
-r
npm:react@19.0.0
-q
"How is useTransition exported?"
Config Overview
Config lives in
btca.config.jsonc
(project) and
~/.config/btca/btca.config.jsonc
(global).
Project config overrides global and controls provider/model and resources.
Troubleshooting
"No resources configured": add resources with
btca add ...
and re-run
btca resources
.
"Provider not connected": run
btca connect
and follow the prompts.
"Unknown resource": use
btca resources
for configured names, or pass a valid HTTPS git URL /
npm: