SkillsAdd

davis7dotsh/better-context

btca-cli

Operate the btca CLI for local resources and source-first answers.

First seen Feb 4, 2026

Installation

$ npx skills add davis7dotsh/better-context --skill btca-cli
View on skills.sh ↗ GitHub repository ↗

Summary

  • 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.

Also in this package

Other skills from davis7dotsh/better-context.

npx skills add davis7dotsh/better-context
btca-local 550 better-result-adopt 34

Browse all from davis7dotsh/better-context

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1.2K
License LICENSE.md
Default branch main
Open issues 24
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,008 B
  • docs SUMMARY.md 336 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 736 installs

SKILL.md

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/[email protected] -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:[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.