Surfaces and profiles

A "surface" is a way to reach your agent. Cremind runs one runtime and exposes it through several front ends, so you can chat from a browser, a desktop window, a terminal, or a messaging app — all talking to the same profiles and conversations underneath.

The four surfaces

Web UI

A Vue 3 + Vite single-page app served on port 1515. This is where the setup wizard lives and where most day-to-day chatting happens. After install your browser opens here automatically.

http://<host>:1515/

Desktop app

The Cremind App is a prebuilt Electron client for Windows, macOS, and Linux that bundles the agent and auto-updates from GitHub Releases. It's the no-script way to run Cremind on a personal machine.

CLI

The cremind command-line tool talks to the same backend. cremind chat opens a streamed REPL against a profile, and cremind --help lists every command — profiles, conversations, tools, agents, channels, and LLM config.

cremind chat
cremind --help

Chat channels

Cremind can also be reached through chat channels such as Telegram, so you can message your agent from a phone or a group chat. Channels connect to the same profiles and conversations as every other surface.

Everything talks to the same backend

Under all four surfaces is one backend API on port 1112. Whichever surface you use, you're hitting the same runtime, the same tool registry, and the same stored conversations — so a chat you start in the Web UI is the same chat you can continue from the CLI.

Profiles isolate each assistant

A surface is how you reach the agent; a profile is which assistant you reach. Profiles are Cremind's unit of isolation. Each profile keeps its own:

• persona and system prompt,
• LLM provider keys,
• installed skills,
• browser profiles,
• conversation history.

Because of that isolation, one install can host several independent assistants at once — a work assistant, a coding assistant, and a home assistant — without context bleeding between them. Your first profile, created during setup, is named admin. You reach the same set of profiles from every surface above.

Next steps