mcpField
B
btca-cli

btca-cli

github.com/davis7dotsh开发1.2k723 次安装29 周前更新
代码仓库

关于 btca-cli

btca CLI 是面向开发者和研究人员、以源代码为依据的研究命令行工具。它将 Git 仓库、本地目录和 npm 包转为可搜索上下文,并基于这些来源回答问题。

主要功能

  1. 01添加 Git、本地和 npm 资源
  2. 02联合查询多个资源
  3. 03使用一次性匿名资源
  4. 04管理项目与全局配置
  5. 05查看已配置资源

适用场景

  1. 01跨仓库研究实现细节
  2. 02查询本地文档内容
  3. 03检查指定版本的 npm 包

安装

复制下面的命令,在终端中运行。

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

安装后在 Claude Code 中输入/btca-cli确认已加载。

附带文件agents/openai.yaml

详细介绍

btca CLI

btca 是一款以源代码为先的研究命令行工具。它会将资源(git、本地资源、npm)加载到可搜索的上下文中,然后基于这些来源回答问题。持续开展工作时,可使用已配置的资源;也可直接在 btca ask 中使用一次性匿名资源。

完整 CLI 参考:https://docs.btca.dev/guides/cli-reference

添加资源:

# 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

验证资源:

btca resources

提问:

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

常见任务

  • 使用多个资源提问:
btca ask -r react -r typescript -q "How do I type useState?"
  • 使用一次性匿名资源提问(不会保存到配置中):
# 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?"

配置概览

  • 配置文件位于 btca.config.jsonc(项目级)和 ~/.config/btca/btca.config.jsonc(全局)。
  • 项目级配置会覆盖全局配置,并控制提供方、模型和资源。

故障排查

  • “未配置资源”:使用 btca add ... 添加资源,然后重新运行 btca resources。
  • “提供方未连接”:运行 btca connect 并按照提示操作。
  • “未知资源”:使用 btca resources 查看已配置的名称,或在 btca ask 中传入有效的 HTTPS git URL / npm:<package> 作为一次性匿名资源。

评论

支持 Markdown