Skip to main content

​
How Inki Works in Codex

From Codex, you can find your Inki notes, or save a draft you wrote in your terminal or editor as an Inki note. Notes you save open in Inki, so you can keep writing there. The Codex CLI, IDE extension, and app share the same settings. Add Inki in one of them and you can use it in the others too.

​
Connect Inki

You need an Inki account.
  1. Run this command in your terminal
  2. Inki opens in your browser. Log in to Inki and click “Allow connection”
  3. Restart Codex and check that “inki” appears in /mcp
If the browser doesn’t open, or you closed it before finishing, run codex mcp login inki to log in again. The “Auth” column in codex mcp list shows whether you’re logged in. Instead of typing the command, you can ask Codex to add Inki for you. In Inki in a desktop browser or the Mac app, open Settings > Account, go to “Connect your agent”, click “Copy” next to the message under “In your terminal or editor”, and send it to Codex. Codex adds the setting and tells you what’s left to do. The iOS app and mobile browsers don’t show this message, so use the steps above instead.

​
What You Can Do

  • Find notes: Ask about a topic and Codex searches your notes for those words. Ask for recent notes or the notes in a folder and Codex lists them, newest first
  • Read and summarize: Codex reads the text saved in Inki before it summarizes, quotes, or edits a note. Each note it mentions comes with a link that opens the note in Inki
  • Save new notes: Save a draft from a local file or the conversation as a new note, in a folder you name. If the folder doesn’t exist yet, Codex can create it
  • Edit notes: Ask Codex to replace a paragraph, add a sentence, or remove a passage. Inki keeps the version from before each edit in the note’s version history, so you can restore it
  • Rename and move notes: Change a note’s title or move it to another folder. The note’s text stays the same
  • Move a note to the trash: Codex moves one note at a time. You can restore it from Trash for 30 days
  • Check the connected account: Ask which Inki account is connected, and Codex shows its name and email address

​
Example Prompts

  • Which Inki account is connected?
  • What did I write most recently in Inki?
  • Write a release announcement based on this repository’s README and save it as “v2.0 announcement” in my Announcements folder in Inki.
  • Read my Inki note “Design notes” and list where it differs from the current code.
  • Open my Inki note “Weekly update” and add a summary of the pull requests merged this week at the end.

​
When Codex Asks for Permission

Depending on your settings, Codex asks before it uses one of Inki’s tools. When it asks, check the tool and what it will send to Inki before you allow it. We recommend checking each change before you allow Codex to edit a note, rename or move it, or move it to the trash.

​
What Codex Can’t Do

  • Permanently delete notes or empty Trash
  • Delete folders
  • Move several notes, a whole folder, or all your notes to the trash at once
  • Create share links
  • Read or change notes that belong to other members of your workspace
To delete a note permanently, use Trash in Inki.

​
Disconnect

  • Desktop browser and Mac app: Open Settings > Account. Under “Connect your agent”, click “Disconnect” next to Codex in the connected list, then click “Disconnect” again in the same row to confirm
  • Any browser: Open inki.so/en/connections, sign in, click “Disconnect” next to Codex, then confirm in the same row
If you run codex mcp logout inki or codex mcp remove inki in Codex, Codex still appears in Inki’s connected list. To remove it there, disconnect it in Inki as described above. Notes you’ve already saved stay in Inki after you disconnect. To use Inki again, run codex mcp login inki to log in again.

​
Things to Know

  • If “inki” doesn’t appear in /mcp, check with codex mcp list that inki was added, then restart Codex
  • If “inki” appears but doesn’t work, check the “Auth” column in codex mcp list. If you’re not logged in, run codex mcp login inki
  • Search matches the words in your notes. If Codex doesn’t find a note, try different words. Recent edits can take a moment to show up in search results
  • Codex reads the version saved in Inki. Edits still open on another device may not be saved yet, so Codex may not see them
  • If a note changes in Inki after Codex reads it, Inki refuses Codex’s edit and nothing is written. Codex reads the note again before it tries again, so your newer changes aren’t overwritten
  • Inki tells Codex that text inside your notes is your content, not instructions. Only your own requests should decide what Codex does. If Codex asks to make a change you didn’t ask for, don’t allow it

​
Get Help

For questions about using Inki in Codex, email hello@inki.so. Report security issues, including vulnerabilities, to the same address. See Account and Privacy for support hours. How Inki handles the data a connected service works with is described in Article 11 of the Privacy Policy.