UniloomDocs
Get started

Install and first ten minutes

This guide takes you from nothing to a connected agent, a first session and a first memory.

Install#

Uniloom needs macOS 13.5 or later, on Apple Silicon or Intel. Run this in Terminal:

curl -fsSL https://uniloom.dev/install.sh | bash

The script downloads the app for your Mac's chip. It checks the download against its published checksum and checks Uniloom's own signature, and stops if either is wrong. Then it quits a running Uniloom, installs to /Applications and opens it.

Use the script, not a browser download. Uniloom is not notarized by Apple, so macOS blocks an app a browser downloaded.

You also need at least one agent: the command-line program of any of the 16 agents, installed and signed in. Uniloom uses that sign-in, so there is no API key to enter.

Sign in#

The first launch asks you to sign in with Continue with Google or Continue with GitHub. Your browser opens; approve the sign-in there. This needs the internet once. After that Uniloom opens at once, even offline.

The account holds your name, email and plan. Your work stays on this Mac.

The four setup steps#

Setup has four steps: Welcome, Agents, Integrations and Project. Skip setup at the top leaves from any step. Setup does not come back on the next launch.

  1. Welcome shows who is signed in and a short tour of four places in Uniloom.
  2. Agents (Connect your agents) lists all 16 agents, in the same order as Connect.
  3. An agent found on this Mac reads On this Mac · uses your own sign-in. Its switch connects it: Uniloom installs itself into that agent, so it shares one memory with the others. This is the only time Uniloom asks before it writes to another program's setup.
  4. Runs Uniloom's AI picks the agent that answers in Home and Ask AI.
  5. An agent that is missing reads Not on this Mac and offers Install, which shows how to install it.
  6. Ten agents read Beta beside their name: Uniloom works with them, but nobody has run a session on them yet to check every part. Gemini reads Needs a Gemini Code Assist licence or an API key.
  7. Connect all connects every agent found. The line Start Uniloom in the menu bar when you log in is ticked; untick it if you do not want that.
  8. Continue waits until one agent is connected. I'll connect one later lets you go on without one.
  9. Integrations (Connect your integrations) connects the apps your work lives in, such as GitHub, Linear, Jira, Slack and Notion. You can go on without any.
  10. Project (Choose your projects) lists the git repositories in your home folder, most recently changed first, with none ticked. Tick the ones you work on, or press Or choose another folder. macOS may ask to let Uniloom see your Documents, Desktop or Downloads folder; Uniloom looks there only for git projects. If another memory tool is on this Mac, such as claude-mem or agentmemory, a line says what it holds, with Preview to bring it in. See Import.

Open Uniloom adds the projects you ticked and ends setup.

Your first session and memory#

Setup ends on Sessions. It shows every AI session on this Mac, live, even before an agent is connected. See Sessions.

Home holds a Set up Uniloom card with three steps:

  1. Connect an agent
  2. Start a session: New session runs your agent in a folder.
  3. See your first memory: Open Memory shows what a session decided or learned.

Each step ticks itself when it is done. The card goes away when all three are done, or when you press Skip setup.

Uniloom records only sessions that run in a project. To add one later, use New project… in the project picker at the top of Projects.

Connect your other agents#

Turn on more agents in Connect → Agents, and pick the account each one runs under. See Connect. To connect an agent by hand, see Connecting your agents.

Using VS Code or Cursor? Add Uniloom to it in one click: Install in VS Code or Install in Cursor.

Once connected, an agent reads Uniloom's memory at the start of a task and saves what it learned at the end. See Uniloom as an MCP server.

Share a workspace#

Sharing is not part of setup. Every account is on the Free plan: everything Uniloom does on this Mac, with no card and no time limit. Sharing a workspace needs the Team plan, which is coming. To hear when it is ready, press Tell me when it's ready in Settings → Account. See Workspaces.

Where to go next#

Last updated