Agents, projects, logins. One place.

A small, fast home for
AI coding agents

Every project gets its own agent, login, and terminal. Switch between them like Slack workspaces.

Close the window; the work keeps going. Free and open source.

Soromi
personal
+
Claude Code v2.1.170
Opus 4.8 (1M context) with high effort · Claude Max
~/soromi/code/packages/protocol
← for agents⧉ In README.md
Built for real projects

Real projects are messy. Soromi isn't.

Many folders, many logins, work that shouldn't stop when you do. Most tools handle one at a time. Soromi handles all of it.

01

A project has many folders

Api, web, mobile. One workspace holds them all, so the agent understands the whole project, not just one folder at a time.

02

You have many logins

Work, personal, client. Each project uses its own login, kept cleanly apart. No logging in and out, no mixing them up.

03

Work keeps going

Lock your machine, close the window. The agents keep working and are right where you left them when you return.

Features

Everything the agent needs, nothing it doesn't

Point it at your folders. That's the whole setup.

Focus the agent

Give the agent only the folders that matter

Pick the folders an agent should see: one, a few, or a whole project. It works with exactly those and ignores everything else.

Less clutter for the agent means clearer answers and fewer wrong turns.

# project: kazomi
folders you picked:
kazomi-api
kazomi-web
kazomi-mobile
 
# the agent sees these, and nothing else

Run several agents at once

Open several terminals in one project and run more projects side by side. Name them, and they all come back after a restart.

Switch like Slack workspaces

Every project sits in the sidebar. Jump between them in a click, each with its own agent, login, and files.

Terminals that stay alive

Close the app and your agents keep running. Open it again and pick up right where you left off.

Logins kept separate

Give each project its own login: personal, work, or client. They never mix, and Soromi stores no passwords.

Know when it needs you

A sound and a notification when an agent needs your input or finishes, even when the app is closed. Mute any project you like.

Keep the machine awake

Keep your machine from sleeping while an agent works, so long jobs finish instead of stalling.

Browse files without leaving

A quick, read-only view of your files. Glance at what the agent did; your real editor stays your editor.

Skills at a click

See each project's commands and skills in the sidebar, and drop one straight into the terminal.

Share a setup, or skip it

Save a project's setup to a small file others can open, or just start fresh. Either way works.

Remote

Your agents, from your phone

Step away from your desk and your agents keep going. Open Soromi in your phone's browser to see what each one is doing and tap to answer when it needs you.

  • Scan a QR code once to pair your phone.
  • Everything travels over a private, encrypted link.
  • No one else can read your work, not even us.
  • Prefer to run it yourself? The relay is yours to host.
So soromi waiting
Running tests…
18 passed, 0 failed
 
Allow write to protocol.rs?
Allow Deny
How it works

Simple under the hood

A small background service does the real work. Whatever you look at, on your laptop or your phone, is just a window onto it.

The engine

Runs your agents

It runs your terminals in the background, keeps track of what each agent is doing, and sends you alerts, window open or not.

always on, quietly
One shared language

Always in sync

The app and the engine speak the same language, so what you see always matches what's really happening.

never out of date
The window

Just a view

The screen only shows what the engine sends and passes your typing back. That's why the very same view can run on your phone.

runs anywhere
Agents

Works with the agents you already use

No new agent to learn. Soromi runs the ones you already have.

AgentSeparate loginsAlertsFolder focusSkills
Claude Code Yes Yes Yes Commands + skills
Codex Yes When it finishes First folder Prompts + skills
Download

Get Soromi for your desk

Free and open source. Grab the installer for your platform.

macOS

Universal build, Apple Silicon and Intel.

Download .dmg

Windows

64-bit installer.

Download installer
Prefer an .msi?

Linux

AppImage, runs on any distro.

Download AppImage
Also as .deb or .rpm

Every build lives on the GitHub releases page.

Deliberately small

What Soromi will never be

What it leaves out is the point.

No roles or personas
No boards, backlogs, or tickets
No prompt library
No usage dashboards
No fiddling with your git branches
No file editing; it stays read-only
No AI gimmicks bolted on
No extra apps to install

It does the job and stays out of the way.

Gather your agents in one calm place

MIT licensed. Point it at a folder and go.