rillmd

briefing

Generate today's Daily Note (or one for a specified date) at reports/daily/YYYY-MM-DD.md by aggregating the day's situation across journals, tasks, workspaces, knowledge, activity-log, and any plugin briefing hooks. Fully automated, no interaction. Use when the user asks for a daily briefing, situational analysis, or "what's going on today/yesterday".

focus

Start (or resume) a Rill workspace from a theme, journal file, or workspace id. Automatically collects related vault context and creates a workspace/{id}/ directory for an interactive Deep Think session. Use when the user wants to begin or continue a workspace-scoped exploration.

Generate today's daily news report at reports/newsletter/YYYY-MM-DD.md by performing WebSearch + WebFetch over the user's 3-layer context (Identity / Attention / Impulse) and producing Alert + Deep Dive + Discovery sections. Fully automated. Use when the user asks for the daily research newsletter.

onboarding

Guide a new user through a 5-8 minute first-time Rill setup — language detection, first journal entry, core concepts (/focus + /distill), an "ask the assistant" prompt, optional morning reminder, and optional Rill app install on macOS. Use when the user runs first-time setup or asks for a tutorial.

page

Have a conversation with a Rill page (pages/{id}.md). Pages evolve through dialogue and incremental edits, not regeneration. Supports conversational session, quick update, page creation, and last-resort full rebuild. Use when the user wants to update, query, or create a Materialized View page.

project

Operate on a project execution hub via six modes — `status` (one-project overview), `continue` (next unblocked task → /solve), `run` (policy-gated autonomous loop that solves tasks until a stop condition), `review` (dependency-tree audit), `list` (cross-project), `new` (create). Each mode auto-runs `/refresh-project` first. Use when the user wants to check a project, pick the next task, autonomously work a whole project, or see what's actionable across projects.

promote

Crystallise a closed workspace's results into its target project. Reads `_summary.md`, proposes Key Facts + Related Workspaces references + new tasks, appends on approval. The bridge between divergent thinking (`/focus`) and convergent execution (`/project`). Use after `/close` has produced `_summary.md`.

pulse

Refresh knowledge/self/current-state.md — a triaged 80-line/6-section snapshot of the user's current state (direction / active workspaces / open tasks / recent decisions / open questions / known contradictions). Called manually, or auto-chained from /distill + /close, or on-demand by /briefing when the snapshot is stale. Use when the user asks for "今の状態" / "current state" / "what's going on across my workspaces", or when a higher-level skill needs a fresh self-snapshot.

refresh-project

Recompute the auto-maintained sections (`## Active Tasks`, `## Related Workspaces`) of `projects/{slug}/_project.md` via mention reverse-lookup, sorted by dependency-resolved priority. Idempotent. Use when refreshing a project's surface, or as a leaf invoked internally by `/project` and `/promote`.

retrospective

Generate a weekly retrospective at reports/retrospective/weekly-{YYYY-MM-DD}.md with 5 sections (Cross-WS Themes / Contradictions / Stale Workspaces / Decision Digest / Self Observations) over the prior ISO week. Auto-appends to knowledge/self/decisions.md (3-month window) and surfaces Self Observation candidates for --finalize approval. Primary habit trigger is the Thursday /briefing nudge. Use when the user runs `/retrospective`, asks for a weekly review, or the briefing nudge requests it.

solve

Execute a Rill task ticket end-to-end via a Plan-gated autonomous flow (ADR-081 two lanes). Phase 3 Plan approval is the only user gate; Phase 4/5 run autonomously. Delegated from /project run, it executes in autonomous mode (policy + Codex PASS replace per-task approval; decision points queue). Resumable via `## Current Position` in `_task.md`.

clip-tweet

Ingest a single Twitter/X tweet URL into inbox/tweets/, fetch its content via fetch-tweet.sh, and generate an organized version with frontmatter and Markdown body in _organized/. Combines `rill clip` with the tweet branch of /distill Phase 2 in one shot. Use when the user supplies a single tweet URL to capture.

eval

Quantitatively evaluate the search quality and efficiency of the Rill knowledge base via natural exploration vs Deep Path ground truth (ADR-050). Run monthly. Computes precision, recall, metadata_contribution, token cost. Use when the user wants to verify whether note structure actually works in practice.

inspect

Diagnose Rill PKM taxonomy health, metadata accuracy, and file integrity. Run weekly. Detects issues and appends mismatched files to knowledge/.refresh-queue for repair by /repair.

morning

Run the daily morning routine — invoke /briefing (Daily Note) followed by /newsletter (research report) inline within the current session. Use when the user starts the day or explicitly asks for the morning routine.

repair

Batch-update knowledge/notes/ frontmatter (tags, mentions, type) for files queued by /inspect. Reads `knowledge/.refresh-queue` and dispatches parallel sub-agents to repair metadata. Use when the user wants to fix queued metadata issues, typically right after /inspect.

sync

Run all enabled plugins sequentially to bulk-sync external sources (Google Meet, Twitter, voice memo, web clipper, etc.). Use when the user wants to pull in fresh entries from configured external sources, or when chaining batch ingestion before /distill.

maintain

Run note quality maintenance — invoke /inspect to diagnose vault metadata, then /repair to fix queued issues. Use when the user wants weekly or periodic Rill vault health maintenance.