https://github.com/adiled/clwnd
clwnd - your sentinel for multiplexed cross-harness AI bots
https://github.com/adiled/clwnd
agentic-coding claude-code claudecode llm opencode opencode-plugins swarm
Last synced: 16 days ago
JSON representation
clwnd - your sentinel for multiplexed cross-harness AI bots
- Host: GitHub
- URL: https://github.com/adiled/clwnd
- Owner: adiled
- License: mit
- Created: 2026-03-20T12:42:27.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-11T11:59:03.000Z (about 1 month ago)
- Last Synced: 2026-04-11T12:19:09.539Z (about 1 month ago)
- Topics: agentic-coding, claude-code, claudecode, llm, opencode, opencode-plugins, swarm
- Language: TypeScript
- Homepage:
- Size: 2.54 MB
- Stars: 10
- Watchers: 0
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Notice: NOTICE
Awesome Lists containing this project
README
\_ clwnd _/
A sentinel for your multiplexed cross-harness AI bots.
Supported today: + OpenCode session governance + Claude Code providers in headless (compliant) mode
```
curl -fsSL https://raw.githubusercontent.com/adiled/clwnd/main/install | bash
```
clwnd ([/klwʊnd/](https://ipa-reader.com/?text=%2Fklw%CA%8And%2F)).
```
clwnd update
clwnd status
clwnd logs
clwnd sessions
clwnd uninstall
```
Needs git, node (v20+), pnpm, opencode, claude.
Core workflow is operational (more coming). See [compatibility](https://github.com/adiled/clwnd/issues/8).
**Config** `~/.config/clwnd/clwnd.json`
| Key | Default | Description |
|---|---|---|
| `maxProcs` | `4` | Max concurrent Claude CLI processes |
| `idleTimeout` | `30000` | Kill idle process after ms (0 = disabled) |
| `smallModel` | `""` | Override small model (empty = auto-discover free model) |
| `permissionDusk` | `60000` | Permission prompt timeout in ms before auto-deny |
| `droned` | `false` | Enable the drone — stream observer, context-loss detection, auto-recovery |
| `droneModel` | `opencode-clwnd/claude-haiku-4-5` | Model for drone LLM assessments |
**External MCP**
MCP servers configured in `opencode.json` are available to Claude. clwnd's daemon spawns and proxies local MCP servers (e.g. context7). Auth-bound (OAuth) MCPs are not yet supported.
clwnd denies file writes in directories parent to `cwd`. Until ask is supported for that, you can use [`opencode-dir`](https://github.com/adiled/opencode-dir) plugin's `/cd` and `/mv` commands to relocate your session to the desired directory.
**Tips**
clwnd currently relies on opencode as _the harness_ because of thorough customizability. Utilize its configuration to the fullest.
- clwnd sanitizes prompts to ensure undisrupted usage, ensure any custom prompts do not depend on xml tags and second-person attributions
- clwnd greatly strips away commonly expected file system tools by any harness, with more superior code and non-code tooling, but does not dictate prompt engineering or reminders around them yet, so take control of that as needed
- clwnd code analysis and authoring tools `read` `do_code` are pure AST-based and are limited to few languages, non-code writing tool `do_nocode` can be relied on for yet unsupported languages