echolisted

# ECHO **Capture decision reasoning. Query it later. Never forget the "why."** --- ## Usage ``` /echo create <name> --decision "what" --reasoning "why" /echo query <id> [question] /echo list ``` --- ## What This Is ECHO captures decision points with their full reasoning context — what was decided, why, what alternatives were rejected, and what unknowns existed at the time. When future-you asks "why did we do it this way?", ECHO has the answer. This is architectural decision records (ADRs) made practical and queryable. --- ## Creating an Echo ``` /echo create auth-strategy \ --decision "JWT with refresh tokens over session-based auth" \ --reasoning "Stateless scales better for our microservices architecture" \ --alternatives "Session cookies, OAuth2 only, API keys" \ --confidence 0.8 \ --unknowns "Token revocation performance at scale" ``` ### Fields | Field | Flag | Description | |-------|------|-------------| | **Name** | (positional) | Human-readable identifier (alphanumeric, hyphens, underscores only) | | **Decision** | `--decision` | What was decided | | **Reasoning** | `--reasoning` | Why this choice was made | | **Alternatives** | `--alternatives` | Comma-separated rejected options | | **Confidence** | `--confidence` | 0.0 - 1.0, how sure you were | | **Unknowns** | `--unknowns` | Comma-separated things you didn't know | | **Project** | `--project` | Project name (defaults to current directory) | | **Context** | `--context` | Additional session co