Architecture decisions
Record a decision when it has meaningful alternatives, consequences, or migration cost. Routine implementation details do not need a record.
0001: Command-first interface
Section titled “0001: Command-first interface”Status: Accepted
Context
Section titled “Context”Kact must integrate with shells and external keyboard remappers while preserving normal typing.
Decision
Section titled “Decision”Expose cursor actions through the CLI and private local Unix socket. Keep global shortcuts disabled by default; configured bindings only add optional local or global activation.
Consequences
Section titled “Consequences”External tools can trigger every action without native keyboard capture. Commands are a stable compatibility boundary and need clear validation and error reporting.