Contributing

clishake is open source and welcomes focused fixes, adapters, tests, documentation, and field reports from real agent CLIs.

Development setup

terminal

$ git clone https://github.com/clishakehq/clishake
$ cd clishake
$ make build
$ make test
$ make demo

The 14-stage demo exercises two mock agents, messaging, tasks, sub-agents, disconnect and reconnect, failure recovery, and the audit trail.

Honest capability reportingNever claim an adapter feature that is not implemented.
Vendor-neutral coreKeep harness-specific behavior under internal/adapter/*.
No silent data lossNever clobber work or auto-resolve conflicts.
Explicit, auditable stateEvery mutation emits an attributed event.
Terminal-native operationEverything must work in a plain terminal over SSH.

terminal

$ make check

Behavior changes need tests. Terminal or adapter changes should run through the demo and, when available, a smoke test against the real harness.