btca-cli

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

Audit 0.4.1 · source sha d097e7c76da7 · 20 Oct 2026Report an issue or request a re-scan

• Publisherdavis7dotsh GitHub organizationOwner of the repository this skill is read from
• Source folderdavis7dotsh/better-context/skills/btca-cliThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdictd097e7c76da7A new audit runs when the source changes
• Repository statusNot archivedLast push 191 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Operate the btca CLI for local resources and source-first answers. Use when setting up btca in a project, connecting a provider, adding or managing resources, and asking questions via btca commands. Invoke this skill…

---
name: btca-cli
description: Operate the btca CLI for local resources and source-first answers. Use when setting up btca in a project, connecting a provider, adding or managing resources, and asking questions via btca commands. Invoke this skill when the user says "use btca" or needs to do more detailed research on a specific library or framework.
---

# 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:

```bash
# 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/[email protected] -n node-types -t npm
```

Verify resources:

```bash
btca resources
```

Ask a question:

```bash
btca ask -r svelte-dev -q "How do I define remote functions?"
```

## Common Tasks

- Ask with multiple resources:

```bash
btca ask -r react -r typescript -q "How do I type useState?"
```

- Ask with anonymous one-off resources (not saved to config):

```bash
# 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:[email protected] -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:<package>` as an anonymous one-off in `btca ask`.

Excerpt, first 2,007 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/davis7dotsh/better-context
git -C better-context checkout d097e7c76da7

Works in

1. 2026-10-20
   ✓SAFE B 89 / 100

   first audit · source d097e7c76da7

Questions about btca-cli

• github.com/davis7dotsh/better-context/tree/main/skills/btca-cli — the audited source at commit d097e7c76da7 and every finding aboveObserved · 20 Oct 2026

Spotted something wrong? Report a correction · Methodology