Getting started
Sign in to Common Ink, write your first note, learn the parts of the app, and connect an AI agent to your notes.
What Common Ink is
Common Ink is a markdown notes app at commonink.app that you share with your AI agents, such as Claude, ChatGPT, Cursor, or any other MCP client. You and your agents read and edit the same notes, and every change records who made it.
Sign in
Common Ink is in a closed beta, so only accounts let into the beta can sign in. To hear when it opens, join the email list.
- Go to https://commonink.app.
- Choose Sign in with Google.
- Pick the Google account that is in the beta.
If you pick an account that isn't in the beta, Common Ink says so on a page titled "Not in the beta yet". Choose Use another account to try a different one.
Write your first note
The first time you sign in, Common Ink makes a workspace for you, named for your first name, such as "Ada's workspace". A workspace holds your notes, folders, and uploads. You are its admin. It starts with your Private, which only you see, with Unsorted in it. Nothing is shared until you make a shared folder and put it there: see Workspaces and sharing.
The app opens on your Dashboard. To write a note:
- Press New note, the plus on the rail at the left edge of the window.
- Type. The note starts empty, with the cursor in it.
- Give it a title. A note's title is its first
#heading. Until it has one, its first line is its title.
Common Ink saves as you type. A note that you never typed anything into is discarded when you close its tab. A note made with no folder open goes in your Unsorted, in your Private. To learn what a note can hold, see Writing notes.
Find your way around
A rail runs down the left edge of the window. The logo at its top opens the workspace menu, which switches between your workspaces and opens Sharing and Settings. Who is in the workspace is in Settings, under Members. Under the logo is New note. The sidebar is beside the rail. Places at its top has links to pages such as Dashboard, Todos, Today, and Calendar. More shows the rest, such as Contacts, Agents, History, Uploads, Trash, and Plugins. Below the links is the folder tree, which starts with All notes, and Tags has a tab of its own on the rail.
Every note, folder, and page opens in a tab. A single click opens a preview tab, shown in italics, and the next single click replaces it. To keep a tab open, double-click it or edit the note. To see two tabs side by side, drag a tab to an edge of the editor, or, when the pane has more than one tab, choose Split right or Split down from the tab's menu. A note's card, a folder, a tag, a page's link, a crumb and New note drag the same way.
The right side works the same way, and starts closed so the note has the room. Each side is a rail of tabs on the outer edge and a stack of sections beside it: Places, Favorites and Folders on the left, and History, Backlinks and Info on the right. Press a section's header to close it. Drag a header to move the section within its stack, to the other sidebar, or onto a rail, where it joins a tab or, between two icons, makes a new one. Drag a rail's icon to move the tab along a rail, or into an open stack to merge its sections there. The ... on a header has the same moves. The ... at the foot of each rail acts on the tab in front: it closes or opens all its sections and moves or merges the whole tab, as a right click on a rail's icon does. A side with no sections left goes away, and comes back when you drag a section to that edge of the window or move one there from its .... Reset sidebar layout puts everything back. Where you put things follows you to any browser. Which sections are open, how tall they are and the tab in front stay in the browser you set them in. A phone keeps its usual layout. To go back to the older layout on a computer, run Toggle stacked sidebars from the command palette, or turn off Stacked sidebars in Settings.
These keys run the commands you use most. On Windows and Linux, use Ctrl in place of Cmd.
| Keys | What it does |
|---|---|
Cmd+Shift+P |
Opens the command palette, which lists every command |
Cmd+P |
Opens quick open, which finds a note or upload by its title or name. Cmd+Enter there opens it to the side |
Cmd+\ |
Shows or hides the sidebar |
Cmd+. |
Turns focus on or off, so one tab fills the window |
? |
Shows every keyboard shortcut, when you aren't typing |
You can change any of these in Settings, under Keyboard shortcuts.
Connect your agent
An agent reads and edits your notes as you, with your role in each workspace and no more. Its changes are recorded under its own name, so you can see what it did and revert it.
To connect one, open the workspace menu, choose Agents, name the agent, and paste the prompt Common Ink gives you into it. Claude and ChatGPT in the browser connect differently. You add Common Ink as a connector in the app, then allow it. Connect an agent covers every client.
Where to go next
- Writing notes covers markdown, links, mentions, embeds, and uploads.
- Todos covers checkbox lines with due dates, priorities, and repeats.
- Search covers finding notes by words, tags, folders, and more.
- Workspaces and sharing covers inviting people and sharing notes.
- History and blame covers seeing who changed what, and reverting it.
- Calendar and contacts covers your Google calendar and contacts in your notes.
- Web clipper covers saving a web page as a note.
- Plugins covers turning features on and off, and adding your own.
- The ink command covers working with your notes from a shell.
- Agent tools lists every tool an agent can call.