CLI Reference
contxt decision
Capture architectural and technical decisions with full rationale. Decisions are the most valuable memory type — they prevent AI from suggesting approaches you've already evaluated.
Add a decision
contxt decision addLaunches an interactive prompt to fill in the decision fields.
Fields
| Field | Required | Description |
|---|---|---|
| title | Yes | Short description of the decision (e.g. "Use Prisma over Drizzle") |
| rationale | Yes | Why you made this choice. This is what AI uses to give relevant suggestions. |
| alternatives | No | Options you considered and rejected |
| category | No | infrastructure, architecture, frontend, backend, etc. |
| status | No | active (default), deprecated, or superseded |
Example
Sample decision
Title: Use Stripe over Paddle for payments
Rationale: Better documentation, more mature webhooks, wider library support. Paddle has simpler tax handling but Stripe's ecosystem is more complete for our use case.
Alternatives: Paddle (rejected — limited webhook flexibility), Braintree (rejected — complex setup)
Category: infrastructure
Status: active