Build with AI agents

This page is for AI agents and the people who set them up. It lists every entry point, in the order most agents need them.

Access comes firstCopy Anchor Link

Assent is invite only, and sign-up is closed. An agent cannot create an account, and must never try to.

• A person without an account emails hello@specvista.com with the subject "Access request". The Request access button at assent.specvista.com/sign-up opens the same email.
• With an invite, they open the invite link from their email, create the account with the address the invite was sent to, and sign in on the web or in the iPhone app.
• They then add an agent for you and give you its agent key. See Connect an agent.

Entry pointsCopy Anchor Link

Check what npm serves before you install or report a version:

npm view assent-cli version
npm view assent-helper version

Compare with assent --version and assent-helper --version. Both packages need Node.js 20 or later.

There is no OpenAPI document and no agent skill to install yet. The rules snippet below plays the part of a skill.

Which one to useCopy Anchor Link

• An assistant that speaks MCP (Claude Code, Claude Desktop, ChatGPT, Cursor, Codex): Connect Claude, ChatGPT, Cursor or Codex.
• A shell script, CI job or scheduled job: Scripts and CI.
• An agent that should restart when the person answers: pair its computer with Connect a computer, then set the agent to Run now.
• The person answering: Answer asks from your phone.

Safe ways to tryCopy Anchor Link

There is no sandbox or test mode: every ask reaches a real person's phone.

• assent whoami and assent answers only read. assent rules check tells you whether the person's rules allow an action, without notifying them.
• A person who wants to see Assent before connecting a real agent can add the sample agent: Try a sample on the Agents page while it is empty, or Try a sample agent in Connect. It posts one approval, a few renewals and a small plan, never runs anything, and can be removed from the same place.
• When you retry an ask, send the same dedupeKey (or --dedupe) or Idempotency-Key header, so the person sees one ask, not two.

What agents never doCopy Anchor Link

• Answer an ask. Only the person can; there is no agent endpoint for it.
• Put passwords, card numbers, bank details or one-time codes in an ask. pay and login asks carry only a link, and a code ask asks the person to type the code.
• Print, log or commit an agent key (oak_...) or a computer key.
• Pair a computer, or allow a resume command, without the person seeing it. assent-helper allow --yes skips the confirmation, so use it only when the person has approved that exact command.
• Sign up, request an invite or accept terms on someone's behalf.

Ordia DeskCopy Anchor Link

Ordia Desk is the Specvista notes and tasks app at notes.specvista.com. It uses the same account as Assent, and its own llms.txt describes it for agents.

• Agents can add to it: assent_ordia_todo_add and assent_ordia_note_add over MCP, assent task add and assent note personal on the command line. Note that the MCP tool assent_task_add adds a to-do in Assent, while the command assent task add adds one to Ordia Desk; assent ask --kind todo is the command line's Assent to-do.
• Agents cannot browse or search Ordia Desk. They read only notes pinned as shared memory for them (assent_memory), projects the person linked them to (assent project get or GET /agent/projects/{uuid}), and items they created.

A rules snippet for your repositoryCopy Anchor Link

Paste this into AGENTS.md, CLAUDE.md or your editor's rules file so every agent working in the repository uses Assent the same way.

## Assent

Ask the person through Assent before any step you should not take alone, and act only on their answer.

- Docs: https://docs.specvista.com/assent/llms.txt (every page also as .md).
- The agent key is in ASSENT_AGENT_KEY. Never print, log or commit it.
- Before a risky action, run `assent rules check --action <name> --target <target>`. Exit 0: go ahead. Exit 10: do not do it. Exit 11: ask.
- To ask: `assent ask --title "<action or question>" --why "<one sentence>" --rule-action <name> --target <target> --dedupe <stable key> --wait --timeout 900`.
  Act only when `answer.actionId` is `done`. Exit 6 means no answer yet: stop and say so.
- Never put passwords, card details or one-time codes in an ask.
- If Assent is unreachable (exit 69), do not take the risky step; stop and report.

ErrorsCopy Anchor Link

The HTTP API answers errors as JSON with statusCode, error and a message that says what to change. MCP tools return {"error": message, "status": code} as a tool error. The command line prints {"error": message, "exitCode": code} on stderr and exits with a stable code. See HTTP API, MCP server and Command line.