When you connect Claude, Cursor, Grok, or ChatGPT from Settings, they work this project through these rinkata tools. Talk in plain language; you don't call these by name.
Some writes still wait on you: Accept, Ratify, and Approve. Agents cannot forge those.
Who is who calls the tool: You (human session only), Agent (connected agent), or Either (reads). Gates and refuse codes live on rinkata_tool_contracts. This page is a directory, not a recipe book.
See the project
| Tool | Who | What it does |
|---|
rinkata_doctor | Either | Run rinkata project health checks. |
rinkata_find_artifact_by_external_ref | Either | Foreign→local lookup over the artifact's external_refs[]. |
rinkata_impact | Either | Read-only multi-hop impact (blast radius) from a Goal section, Spec, Ticket, or Decision root. |
rinkata_list_projects | Either | List rinkata projects in the bearer's tenant. |
rinkata_read_artifact | Either | Read any rinkata artifact's frontmatter + markdown body by id or canonical .rinkata path (legacy .plumb paths are also accepted). |
rinkata_search | Either | Search project artifacts by content BEFORE creating a Goal, spec, or ticket. |
rinkata_status | Either | Read project status: counts, graphHash, plus server-computed summaries for orient (drift.top, inFlight.top, recent.items). |
rinkata_tool_contracts | Either | Read the machine-readable agent contract catalog for every registered rinkata capability. |
rinkata_work_queue | Either | Read an agent-ready work queue combining ticket lifecycle, alignment, blockers, evidence, and health signals. |
Ideas
| Tool | Who | What it does |
|---|
rinkata_classify_idea | Agent | Attach an advisory classification to an idea. |
rinkata_comment_idea | Agent | Append a comment to an idea WITHOUT altering its captured prose, the way to attach a finding, a correction, or context after capture. |
rinkata_create_idea | Agent | Capture a lightweight idea artifact for later triage. |
rinkata_idea_set_state | Agent | Set an idea's lifecycle state: archive a captured/triaged idea to dismiss it from the active inbox, or unarchive (restore) an archived idea back to active. |
rinkata_list_ideas | Either | List captured idea artifacts from Hub. |
rinkata_promote_idea | Agent | Promote an idea into a concrete artifact while preserving the original idea and recording promoted_to provenance. |
rinkata_repair_idea_promotion_links | Agent | When a live origin_idea target exists, append it into promoted_to (keeping archived tombstones) and seal a captured/triaged idea (promoted + promoted_at) so it leaves the inbox. |
Knowledge
| Tool | Who | What it does |
|---|
rinkata_knowledge_ask | Either | Ask a question over this project's Knowledge (uploaded docs) with citations. |
rinkata_knowledge_list | Either | List this project's Knowledge areas and documents. |
rinkata_knowledge_read | Either | Read one Knowledge document's extracted text. |
rinkata_knowledge_record | Agent | Write a markdown note into Knowledge under an existing customer area, or Unfiled. |
rinkata_knowledge_upload | Agent | Upload a file into this project's Knowledge File Search corpus. |
Tickets
| Tool | Who | What it does |
|---|
rinkata_claim | Agent | Claim an assignable artifact for yourself: set its assignee to the caller (the agent principal over stdio, or your tenant-user via Hub). |
rinkata_complete_ticket | Agent | Mark a ticket done with deployed evidence. |
rinkata_create_ticket | Agent | Create a new feature ticket. |
rinkata_list_tickets | Either | List tickets filtered by status × goalPath × assignee. |
rinkata_preflight_ticket | Either | Check whether a ticket is safe, stale, blocked, or unknown before work starts. |
rinkata_read_ticket | Either | Read a ticket's full frontmatter + markdown body from Hub DB. |
rinkata_set_assignee | Agent | Set or clear the assignee on a ticket. |
rinkata_set_ticket_source | Agent | Re-anchor an EXISTING ticket onto a Goal (whole body or #section), complements rinkata_set_ticket_spec. |
rinkata_set_ticket_status | Agent | Flip a ticket's status (todo, in_progress, blocked, archived). |
rinkata_supersede_tickets | Agent | Archive N open tickets as superseded by one surviving ticket in a single call, the reviewable alternative to N bare set_ticket_status(archived) writes. |
rinkata_write_ticket_body | Agent | Replace the markdown body of a ticket. |
Specs
| Tool | Who | What it does |
|---|
rinkata_approve_completed_spec_reopen | You | Human-only: stamp durable reopen approval on a derived-complete (completed) spec, bound to the current spec version and reviewed graph hash. |
rinkata_approve_spec | You | Human approve for a drafting spec: verifies human principal or durable stamp, checks version+graphHash, applies peer disposition if required, transitions drafting→approved, resolves open spec_approval/peer_disposition review requests, records audit (status write + review resolve share one DB transaction). |
rinkata_archive_spec | Agent | Archive a spec and apply a downstream policy to its member tickets. |
rinkata_create_spec_stub | Agent | Create a lightweight deterministic spec stub anchored at a Goal section. |
rinkata_create_standalone_spec | Agent | Create a standalone spec without a parent Goal section. |
rinkata_create_successor_spec | Agent | mint a standalone successor SPEC with predecessor pre-filled from a derived-complete SPEC. |
rinkata_extract_spec | Agent | Create a new spec stub anchored at a Goal section. |
rinkata_list_specs | Either | List non-archived specs with status, source, ticket count, derived state. |
rinkata_move_spec | Agent | Move a spec to a different Goal section. |
rinkata_plan_from_spec | Agent | plan-on-create execution. |
rinkata_read_spec | Either | Read a spec's frontmatter + body. |
rinkata_set_spec_acceptance | Agent | Replace a spec's typed acceptance: array atomically. |
rinkata_set_spec_assignee | Agent | Set or clear the assignee on a spec, the single member accountable for driving it to completion (distinct from the free-form authors[] contributor list). |
rinkata_set_spec_sequence | Agent | Set a spec's recommended order hint (sequence: [TICK-…]) through a constrained frontmatter-only write. |
rinkata_set_spec_source | Agent | Retarget a spec to a different Goal section. |
rinkata_set_spec_status | You | Transition a spec's status. |
rinkata_set_ticket_spec | Agent | Re-anchor an EXISTING ticket onto a spec, the programmatic equivalent of linking a ticket to a (standalone or Goal-section) spec. |
rinkata_write_spec_body | Agent | Replace the markdown body of a spec. |
Goals
| Tool | Who | What it does |
|---|
rinkata_approve_goal | You | Constrained Goal governance approve: draft → active. |
rinkata_create_goal | Agent | Create a new Goal in Hub DB. |
rinkata_list_goals | Either | List Goals filtered by status. |
rinkata_set_goal_assignee | Agent | Set or clear the assignee on a Goal, the single member accountable for it. |
rinkata_write_goal | Agent | Update an existing Goal in Hub DB. |
Decisions
| Tool | Who | What it does |
|---|
rinkata_list_decisions | Either | List decisions filtered by lifecycle status. |
rinkata_log_decision | You | Capture a new decision artifact for the project. |
rinkata_propose_from_decision | Either | Propose staged reconcile plan(s) from an accepted/ratified decision's affects[] fan-out (GOAL-PLUMB-43 P2). |
rinkata_ratify_decision | You | Human-only: stamp durable ratified_at + ratified_by on a Decision (GOAL-67 S5 / IDEA-PLUMB-119). |
rinkata_update_decision | You | Update a decision's lifecycle status, owner, structured options, or supersede-in-state link. |
Inbox
| Tool | Who | What it does |
|---|
rinkata_inbox_add | Agent | Capture a new inbox note. |
rinkata_inbox_list | Either | List inbox notes. |
rinkata_inbox_promote | Agent | Promote a raw inbox note into a tracked ticket and resolve the note in one step. |
rinkata_inbox_resolve | Agent | Mark a raw inbox note resolved without promoting it to a durable decision. |
rinkata_inbox_set_state | Agent | Transition a raw inbox note to a terminal state: resolved, archived, or discarded. |
Handoffs
| Tool | Who | What it does |
|---|
rinkata_amend_handoff | Agent | Append a correction to a handoff WITHOUT rewriting or superseding it. |
rinkata_list_handoffs | Either | List session handoffs newest-first, filterable by state (default open), about, and query (keyword search over title+body+id). |
rinkata_read_handoff | Either | Read a session handoff. |
rinkata_set_handoff_state | Agent | Transition a handoff one-way: open→consumed (stamps consumed_at/consumed_by), open→archived, or consumed→archived. |
rinkata_write_handoff | Agent | Stash a session-handoff prompt for the next session/context window. |
Reconcile
| Tool | Who | What it does |
|---|
rinkata_apply_staged_reconcile | You | Apply a staged reconcile plan (Goal→Spec or Spec→Ticket) only after explicit human approval of that concrete plan. |
rinkata_list_drift | Either | Read non-aligned ticket drift for the current rinkata project. |
rinkata_propose_reconcile | Either | Compute the current reconcile proposal without writing files. |
rinkata_propose_staged_reconcile | Either | Propose a two-stage (Goal→Spec or Spec→Ticket) staged reconcile plan for a target, same semantics as the Hub UI staged reconcile. |
rinkata_reconcile_apply | You | Apply a Hub reconcile plan only after explicit human approval of that concrete plan. |
rinkata_reconcile_write | Agent | Write a Hub reconcile plan as a review artifact. |
Complete
| Tool | Who | What it does |
|---|
rinkata_complete_spec | Agent | Complete a spec (verify member tickets are done/archived). |
rinkata_list_demo_reviews | Either | List the actionable Demo Pack review queue from Hub. |
rinkata_propose_demo_evidence | Agent | Attach completion evidence for a spec from an agent or API-key context. |
rinkata_read_demo_pack | Either | Read a spec's Demo Pack readiness projection from Hub. |
rinkata_set_spec_demo_required | Agent | Toggle a spec's demo_required policy flag through a constrained frontmatter-only write. |
rinkata_upload_demo_screenshot | Agent | Upload a PNG/JPEG/WebP screenshot into the Hub screenshot store for Complete evidence (SPEC-PLUMB-7). |
More
| Tool | Who | What it does |
|---|
rinkata_list_agents | Either | List agents in the bearer's tenant (GOAL-PLUMB-4). |
rinkata_list_gate_events | Either | Read the human-gate ledger rows for one subject (spec, Goal, ticket, or Decision id), oldest first, with every column. |
rinkata_list_users | Either | List users in the bearer's tenant. |
rinkata_project_list_repos | Either | List the repos attached to a rinkata project, primary first. |
rinkata_rank_anchor_repair | Either | S4 / TICK-PLUMB-942: rank section-anchor repair candidates for a ticket or spec with a broken/tombstoned/suspect source_anchor_id. |
rinkata_read_hub_image | Either | Fetch one HubImage as MCP ImageContent so agents can vision-read a design attached to an idea (or rehomed onto a Goal/spec/ticket). |
rinkata_record_human_approval | You | Human-only: stamp a durable human review approval on a Goal or drafting spec, bound to current version+graphHash. |
rinkata_repair_task_graph | Agent | Repair task-graph inverse edges by making blocks and blocked_by mirror each other. |
rinkata_submit_feedback | Agent | Volunteer free-form feedback about using rinkata itself, friction, a confusing error, a surprising or great result. |
See also
