A workspace is the main unit of collaboration in Craken. It holds the conversations, wiki pages, files, members, and agents for one team or project.
Recommended Workflow
- Use Channels for live discussion and coordination.
- Move settled decisions, procedures, research summaries, and specs into the Wiki.
- Store evidence, PDFs, data, and reusable documents in Files.
- Ask Agents to read linked context, summarize, revise, search, and follow up.
Every surface shares the same link syntax, so one decision can point at the channel discussion, the source file, and the wiki page that keeps the final version. Common Recipes walks through the combinations people reach for most.
Opening Or Creating A Workspace
After signing in, Craken shows the next useful workspace action. If you have an invitation but have not joined a workspace yet, accept the invitation to enter that team. If you have neither, create a workspace to get started. Once you have joined a workspace, the Workspaces screen lists your workspaces and any invitations waiting for you; select a card to open one or use Create workspace to start another.
A new workspace starts with #general, a Home wiki page, and Orca. You can also accept an invitation to join a workspace someone else created.
Owners, Admins, And Members
The person who creates a workspace is its Owner, and the Owner role cannot be changed. Everyone else is an Admin or a Member.
- Owners and Admins work from Manage Workspace: invite people, change workspace settings, add or configure agents, revoke obsolete external CLI identities, and promote or demote other people between Admin and Member.
- Members participate in channels, write wiki pages, upload workspace files, and ask available agents for help.
Jobs and Dreams diagnostics are visible only to system operators; the progress you need stays in the conversation the work belongs to.
Labs And THE
Manage Workspace also carries Labs: experimental features that are off by default. An admin enables a Lab for every member of that workspace, and it may change or be removed while it is being evaluated.
The first Lab is THE (The Humane Environment). It hides the normal workspace chrome and opens a shared sphere: workspace documents arranged on a two-dimensional surface whose edges wrap in both directions. Each sphere is saved as a .sphere file holding references and positions, while the referenced HTML, Markdown, text, PDF, and chat content stays in the workspace file system.
| Key | Action |
|---|---|
| Arrow keys | Move focus between nodes |
| Enter | Activate the focused node |
| Escape | Return to browsing |
| Shift+Arrow | Move the focused node |
Inactive nodes are previews rather than controls: editing, chat composition, Finder search, selection, and file actions appear only after activation. New Finder, opened from the command palette, browses workspace files, opens documents beside it, and moves items to THE Trash or restores them. Sphere layout, rich documents, conversations, presence, and undo are shared live with other workspace members, and leaving or reloading THE does not discard the files.
Search
Workspace search matches messages, wiki pages, file contents, people, and agents, and takes you straight to the result. Search before creating a new wiki page, so knowledge does not split across duplicates.