iri docs

Quickstart

10 minutes from signup to a working iri workspace, your AI agent reading from it, and (optionally) your Slack or Telegram capturing into it.

1. Sign up

Open the iri site, create an account with email + password (or accept an invite link if you've got one).

A personal workspace is created automatically on signup. You can also create a team workspace from the Workspaces menu and invite teammates by email.

2. Add your first material

Pick whichever fits how you actually work:

  • Write directly. Top nav → Write. Markdown editor.
  • Drop a file. Drag a PDF, DOCX, or markdown file into the workspace. iri converts and indexes it in the background.
  • Sync an existing tool. Workspace → Sync → Apple Notes / Obsidian / Notion / Confluence. Initial pull takes a few minutes; updates after that are incremental.

When a document arrives, iri splits it into searchable chunks, embeds them, and (on Pro) extracts knowledge atoms. You can keep working while this runs.

3. Search

Cmd+K (Ctrl+K) anywhere. Plain language works.

  • "what did we decide about pricing?"
  • "Q2 revenue target"
  • "OAuth section of the security policy"

iri runs keyword and semantic search together, so even when wording doesn't match, the relevant note surfaces.

4. Connect your AI agent (recommended)

This is the wedge feature. Claude Code, Cursor, and Claude Desktop all support MCP, the protocol iri uses.

  1. Workspace → Integrations → API Keys (or the workspace dashboard).
  2. Create a key. Copy the iri_ws_… value somewhere safe; it's shown once.
  3. Add iri to your agent's MCP config. Per-tool snippets in MCP overview.

Once wired, your agent can:

  • search_notes, read_note — read your workspace
  • create_note, update_note — write back to it
  • get_briefing — ask iri to assemble a structured answer
  • query_atoms, explore_entity — query the semantic layer

Try asking your agent "what's in our iri workspace about [topic]?" and watch it pull from your notes.

5. Connect Slack (optional)

If your team's decisions live in Slack, this is the second-highest leverage step.

  1. Workspace → Integrations → Slack → Install to Slack.
  2. Pick a default target sphere (where summaries land).
  3. In any Slack channel, /invite @iri.
  4. Run /iri-summary (or /iri-summary 6h) to convert the channel's recent messages into an iri note.

Other commands: /iri-ask <question>, /iri-find <query>, /iri-capture <text>, /iri-recent. Per-channel routing under Slack integration.

6. Connect Telegram (optional)

For mobile capture and brain-dumping in 1:1.

  1. Workspace → Integrations → Telegram → Generate link.
  2. Send the /start CODE to the iri bot in Telegram (button or copy/paste).
  3. Pick a default sphere (e.g. personal/journal).
  4. Type any thought into the 1:1 chat. Run /summary at the end of the day.

Setup details: Telegram integration.

7. What's next

If you get stuck, hello@iri-ai.com.