usemeridian.us

Create a new Meridian project.

Register this Claude session. Call at session start.

Register session and return goal + recent tasks in one call.

Read the current goal state.

Set or update the goal state.

Log a task this session completed or is working on. Valid statuses: pending, in_progress, done, failed, backlog, future, backburner.

Get recent tasks across all sessions.

Search tasks by keyword or natural-language query. Uses trigram similarity on Postgres, LIKE on SQLite. Returns top matches with similarity score.

Generate a context handoff. mode='full' writes the complete L0/L1/L2 handoff; mode='delta' returns a compact session update (completed + pending + /go

Return a compact plain-text project context block (north star, sprint, pending sprint items, recent tasks, recent decisions, active sessions). mode='f

Create a pinned decision (editable constitution row). Use for the current authoritative truth that supersedes earlier statements. category is free-tex

Patch a pinned decision. Pass new_title + new_body to atomically supersede (creates a new active row, marks old as superseded with back-link). Otherwi

List pinned decisions (active only by default, newest first).

Hard-delete a pinned decision by id. Use when something was filed by mistake or is a duplicate. For retiring a valid but superseded decision, use upda

Save progress mid-session. Runs auto_capture (buckets done tasks into a note), generates a delta handoff, and returns a compact summary with what was

Surface a question to the human-in-the-loop queue. urgency='blocking' means this session pauses until answered (poll get_hitl_request). urgency='norma

Poll a HITL request for the human's answer. Returns the row including status ('pending'|'answered'|'dismissed') and answer text.

Add a per-project wiki note (setup, gotcha, howto, env, ...). Free-form title/body; comma-separated tags optional.