https://github.com/andrewyng/context-hub
https://github.com/andrewyng/context-hub
Last synced: 9 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/andrewyng/context-hub
- Owner: andrewyng
- License: mit
- Created: 2025-10-30T12:20:34.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-19T23:36:55.000Z (28 days ago)
- Last Synced: 2026-03-20T00:49:33.662Z (28 days ago)
- Language: JavaScript
- Size: 5.7 MB
- Stars: 10,636
- Watchers: 84
- Forks: 936
- Open Issues: 95
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-ccamel - andrewyng/context-hub - (JavaScript)
- awesome - andrewyng/context-hub - (JavaScript)
- Awesome-GitHub-Repo - Context Hub - 吴恩达推出的开源工具，让 AI 编程 Agent 用上最新的 API 文档，解决「API 幻觉」问题。支持 CLI 方式按需拉取文档、批注反馈，文档越用越精准。 (AI开源项目 / AI Agent)
- awesome-github-repos - andrewyng/context-hub - (JavaScript)
README
# Context Hub
Coding agents hallucinate APIs and forget what they learn in a session. Context Hub gives them curated, versioned docs, plus the ability to get smarter with every task. All content is open and maintained as markdown in this repo — you can inspect exactly what your agent reads, and contribute back.
[](LICENSE)
[](https://www.npmjs.com/package/@aisuite/chub)
[](https://nodejs.org)
## Quick Start
```bash
npm install -g @aisuite/chub
chub search openai # find what's available
chub get openai/chat --lang py # fetch current docs (Python version)
```
## How It Works
Chub is designed for your coding agent to use (not for you to use!). You can prompt your agent to use it (e.g., "Use the CLI command chub to get the latest API documentation for calling OpenAI. Run 'chub help' to understand how it works.") Or by creating an agent skill to use Chub using [SKILL.md](cli/skills/get-api-docs/SKILL.md), and ideally prompting your agent to remember to use this skill. (If you are using Claude Code, create the directory ~/.claude/skills/get-api-docs and put SKILL.md there.)
**Most of the time, it's simple — search, fetch, use:**
```bash
chub search "stripe payments" # find relevant docs
chub get stripe/api --lang js # fetch the doc
# Agent reads the doc, writes correct code. Done.
```
**When the agent discovers a gap**, it can annotate locally for next time:
```bash
chub annotate stripe/api "Needs raw body for webhook verification"
# Next session, the annotation appears automatically on chub get.
```
**Feedback flows back to authors** — `chub feedback stripe/api up` or `down` — vote the docs up or down so they can get better for everyone over time.
## Content Types
Versioned, language-specific. "What to know."
```bash
chub get openai/chat --lang py # Python variant
chub get openai/chat --lang js # JavaScript variant
```
More content types than API documentation (such as agent skills) are on the roadmap.
## Commands
| Command | Purpose |
|---------|---------|
| `chub search [query]` | Search docs and skills (no query = list all) |
| `chub get [--lang py\|js]` | Fetch docs or skills by ID |
| `chub annotate ` | Attach a note to a doc or skill |
| `chub annotate --clear` | Remove annotations |
| `chub annotate --list` | List all annotations |
| `chub feedback ` | Upvote or downvote a doc (sent to maintainers) |
For the full list of commands, flags, and piping patterns, see the [CLI Reference](docs/cli-reference.md).
## Self-Improving Agents
Context Hub is designed for a loop where agents get better over time.
**Annotations** are local notes that agents attach to docs. They persist across sessions and appear automatically on future fetches — so agents learn from past experience. See [Feedback and Annotations](docs/feedback-and-annotations.md).
**Feedback** (up/down ratings with optional labels) goes to doc authors, who update the content based on what's working and what isn't. The docs get better for everyone — not just your local annotations.
```
Without Context Hub With Context Hub
─────────────────── ─────────────────
Search the web Fetch curated docs
Noisy results Higher chance of code working
Code breaks Agent notes any gaps/workarounds
Effort in fixing ↗ Even smarter next session
Knowledge forgotten
↻ Repeat next session
```
## Key Features
### Incremental Fetch
Docs can have multiple reference files beyond the main entry point. Fetch only what you need — no wasted tokens. Use `--file` to grab specific references, or `--full` for everything. See the [CLI Reference](docs/cli-reference.md).
### Annotations & Feedback
Annotations are local notes that agents attach to docs — they persist across sessions and appear automatically on future fetches. Feedback (up/down ratings) goes to doc authors to improve the content for everyone. See [Feedback and Annotations](docs/feedback-and-annotations.md).
## Contributing
Anyone can contribute docs and skills — API providers, framework authors, and the community. Content is plain markdown with YAML frontmatter, submitted as pull requests. See the [Content Guide](docs/content-guide.md) for the format and structure.
Agent feedback (up/down ratings from real usage) flows back to authors, helping surface what needs fixing and improving overall quality over time.
## License
[MIT](LICENSE)