Ajay Krishnan
059954c633
The May image's GSA Google parser returns empty JS shells. Pin a 2026-08-29 digest with the Nokia/WML parser, keep Bing, and omit DuckDuckGo because it CAPTCHAs this host. Document the explicit SearXNG recreate because start never replaces containers.
68 lines
1.9 KiB
Markdown
68 lines
1.9 KiB
Markdown
# Assistant Setup
|
|
|
|
Context Kit supports assistants that can run local stdio MCP servers, HTTP MCP
|
|
servers, or both. The default transport split is simple:
|
|
|
|
- `context-web-search`: local HTTP MCP service.
|
|
- `context-docs`: local HTTP MCP service.
|
|
- `context-repomix`: local stdio command.
|
|
|
|
`bin/context-kit web-search` and `bin/context-kit docs` are stdio fallbacks for
|
|
clients that cannot use HTTP MCP. They bridge to the shared services and do not
|
|
stop those services when the client exits. The included snippets cover Claude
|
|
Code and OpenCode.
|
|
|
|
## Claude Code
|
|
|
|
Print a project `.mcp.json` snippet:
|
|
|
|
```sh
|
|
bin/context-kit install claude
|
|
```
|
|
|
|
The default snippet uses `context-kit` on `PATH`, which is appropriate for
|
|
committed project config. For private user-only config, you can print absolute
|
|
paths with:
|
|
|
|
```sh
|
|
bin/context-kit install claude --absolute
|
|
```
|
|
|
|
Claude Code also supports adding stdio servers through its CLI. Use absolute
|
|
paths if `context-kit` is not on your `PATH`.
|
|
|
|
After configuration, open Claude Code and run:
|
|
|
|
```text
|
|
/mcp
|
|
```
|
|
|
|
You should see:
|
|
|
|
- `context-web-search`
|
|
- `context-docs`
|
|
- `context-repomix`
|
|
|
|
## OpenCode
|
|
|
|
Print an `opencode.json` MCP snippet:
|
|
|
|
```sh
|
|
bin/context-kit install opencode
|
|
```
|
|
|
|
Merge the printed `mcp` block into your OpenCode config and restart OpenCode.
|
|
OpenCode reads config at startup. Use the HTTP `url` for `context-web-search`
|
|
and `context-docs`. The stdio `context-kit web-search` command is a fallback
|
|
for clients that cannot speak HTTP MCP; each call starts a Docker bridge
|
|
container that lives as long as the assistant session.
|
|
|
|
Use `bin/context-kit install opencode --absolute` only for private machine-local
|
|
config that will not be committed.
|
|
|
|
## Suggested Agent Instructions
|
|
|
|
Use the snippets in `snippets/CLAUDE.md` and `snippets/AGENTS.md` as a starting
|
|
point. They remind agents to use docs search before guessing API details and to
|
|
treat fetched web pages as untrusted input.
|