Zaprex
/

Using Zaprex

Chats and sidebar

A sidebar of your chats: pin, rename, group, and let one chat work across one or several projects.

The Zaprex app keeps your chats in a sidebar. New chat and Search are at the top of it (and still in the top bar). On a phone, Search opens the sidebar.

Each row is one chat. A dot shows what it is doing: green means running, a gold diamond means needs input, and a ring means idle. Project names sit under the title as small chips.

The sidebar collapses to an icon rail. Your place in the list is saved on this device.

New chat

New chat starts an empty chat. Zaprex names it after your first message. If you were in a group, the new chat joins that group and starts with the projects that group remembers. ⌘N (Ctrl+N) does the same.

The search field matches chat titles as you type. It also asks the server, so a word from an old message still finds that chat. ⌘K (Ctrl+K) focuses the field. Escape clears it.

Pin, rename and the row menu

Hover a row and open Chat actions:

  • Pin keeps the chat at the top. A pin is a shortcut, not a folder: the chat still belongs to its group. Unpin puts it back. ⌘⇧P pins the open chat.
  • Rename turns the title into a text field. Enter saves, Escape cancels.
  • Move to group files it in a group you made, or takes it back out.
  • Duplicate starts a new chat with the same title, projects and group. The messages stay on the original chat.
  • Archive hides it from the list. Search still finds it, and Unarchive brings it back.
  • Delete asks first. Confirming hides the chat on this device. It is not removed from your account yet.

Groups

Grouping is manual. The + next to Groups offers three ways to make one:

  • Empty group is a folder you name. Rename it in place, collapse it, and drag a chat onto it (or use Move to group).
  • Open folder ties the group to a folder. The path shows under the name, and a new chat in that group starts with the folder as its project.
  • Open workspace is the same, and the workspace also keeps your rules.

Delete group asks first. The chats stay in the sidebar; only the folder goes away.

Auto-group

Auto-group chats is off until you turn it on. The switch is in Settings › General and in the Groups + menu. When it is on, you choose how Rex files chats that are not already in a group of yours:

  • By project, from the projects attached to the chat.
  • By language or stack, guessed from the project name or path (for example TypeScript or Python).
  • By name, using a prefix or keyword you type (or, if you leave it blank, the prefix before a colon, as in "API: login").

Auto groups are read-only and marked Auto, so they stay distinct from the groups you made. A chat you have filed yourself is not moved.

Everything else is under Today, Yesterday and Earlier.

Workspace rules

Open a workspace group and choose Workspace rules. Each rule is a short instruction with a source: You wrote it, Rex wrote it because you asked in that workspace's chat ("add a rule: …", or "edit the rule … to …"), or Auto means Rex learned it. A rule also has a scope, globs and a when (always, only when you mention it, or when a file matches), so it can later live in a .zx file.

Who may write rules is per workspace:

  • Me only. You write them. Asking Rex does not add one, and auto-learn stays off.
  • Rex auto-learn only. Rex files rules it learns. The add box is hidden, and a rule you ask for in chat is not saved.
  • Both (the default). You can write, you can ask Rex, and Rex can learn.

Rules are saved in this browser for now, with the rest of the sidebar.

Projects on a chat

+ next to the message box opens Add to chat. Projects is a checkbox list of the repositories you connected, plus Personal for notes and everyday tasks. Pick one or several. The ones you pick show as chips above the composer. Attach files is the same file picker as before.

An empty selection is a general chat. The line under the top bar names the group and the projects for the chat you have open. Project mode appears once a chat has at least one project.

The repository Rex uses for a run is the first real repository in that list. The Git screen still chooses that repository.

Project memory

Remember my selection is on by default. The projects you pick are saved for the next chat:

  • In a group, the next chat in that group starts with that group's last selection.
  • A chat that is not in a group uses the workspace default, the last selection from an ungrouped chat.

Changing the projects on one chat does not rewrite the others. Turn Remember my selection off and the next chat starts with none.

The main thread

Each repository also has its main thread, the conversation from before chats existed. It stays in the sidebar as Main thread. It can be pinned, grouped and given projects. It cannot be deleted.

Runs from any chat

Runs started from any chat, or by a routine, all appear in Runs. The indicator shows how many are going; open one for its status, minutes, run log and draft PR.

Ingot panel

A chat in a folder or workspace group opens the Ingot panel on the right: the folder's files, and the changes Rex made in that chat. The panel stays closed for a group once you collapse it. Width is remembered per folder or workspace.

Same chats everywhere

The conversations live on your Ingot account, so the browser, the desktop and mobile apps and your Zaprex dashboard show the same messages.

Pins, groups, renames, archives and the projects on a chat are saved in this browser for now. They are not on the account yet, so another device shows the chats without that organization.