Clyde is a local Go CLI and daemon for reading raw provider artifacts, exposing conversation search and transcript export through CLI and MCP surfaces, hosting adapter ingress, and capturing provider traffic through daemon-owned MITM listeners.
Use Clyde for provider-owned artifact inspection. Use raw claude and codex
for provider session lifecycle and interactive work.
Clyde moves quickly, so this README intentionally avoids copied command tables, config schemas, route inventories, model catalogs, and listener lists. Use the generated help or the focused documentation for details that can drift:
- CLI commands:
clyde --helpandclyde <command> --help. - Conversation model, IDs, indexing, compaction segments, and export selection: conversations.
- Conversation CLI and MCP operations:
clyde conversation --help. - Runtime config: start from the example configuration.
- Adapter model routing and catalog behavior: adapter model routing.
- Adapter Responses API (
/v1/responses) and per-provider compatibility warnings: adapter compatibility warnings. - Cursor ingress and error behavior: Cursor.
- MITM listeners and capture behavior: wire baseline and Cursor MITM setup.
- Logging, sinks, request paths, and inventory: logging.
The root command routes the CLI. One conversation-operation registry renders both CLI and MCP surfaces, and alignment tests keep them consistent.
curl -fsSL https://raw.githubusercontent.com/agoodkind/clyde/main/install.sh | bashThe common user config path is:
~/.config/clyde/config.toml
Copy only the sections you need for your adapter, logging, search, and MITM setup.
External gRPC clients can read [daemon] grpc_address; it defaults to unix://
plus the user-scoped daemon socket path.
Use generated help to discover the current operational surface:
clyde --help
clyde conversation --help
clyde daemon --help
clyde logs --help
clyde mitm --helpReload a running daemon after local config changes:
clyde daemon reloadState, logs, caches, adapter records, and MITM captures follow Clyde's XDG path
resolution. Use clyde logs --help for current paths and retention behavior.
Use daemon metrics history to inspect retained adapter activity with clyde daemon status --since 1h.
Try a change against a real daemon without disturbing the deployed one:
clyde daemon sandboxIt runs one daemon on throwaway directories with every listener disabled, and ends when the command ends. See docs/testing/overview.md.
Common checks and build steps are Makefile-owned. Start with:
make build
make test
make lintUse make deploy when the local daemon install and reload path needs to be
validated.
Clyde is forked from Fabio Rehm's original clotilde project.
This project is licensed under the MIT License. See LICENSE.