mcpField
B
btca-cli

btca-cli

github.com/davis7dotshDevelopment1.2k723 installsUpdated 29w ago
Repository

About btca-cli

btca CLI is a source-first research command-line tool for developers and researchers. It makes Git repositories, local directories, and npm packages searchable context, then answers questions grounded in those sources.

Key features

  1. 01Add Git, local, and npm resources
  2. 02Query multiple resources together
  3. 03Use one-off anonymous resources
  4. 04Manage project and global configuration
  5. 05Check configured resources

Use cases

  1. 01Research implementation details across repositories
  2. 02Ask questions about local documentation
  3. 03Inspect a specific npm package version

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/davis7dotsh/better-context --skill btca-cli

After installing, type/btca-cliin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

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.

Comments

Markdown supported