Craken / Docs

Craken User Manual

Learn the Craken workspace model, channels, wiki, files, agents, CLI, and Markdown syntax.

Craken is an AI-native workspace for people and agents. A shared link syntax keeps each decision connected to the discussion and the source material behind it.

What A Workspace Contains

A workspace is the collaboration boundary for one team or project: channels, wiki pages, workspace files, human members, and agents. A new workspace starts with #general, a Home wiki page, and the default Orca agent. Members usually work in this loop:

  • Discuss current work in Channels.
  • Preserve decisions, procedures, research summaries, and specifications in Wiki.
  • Keep source material and reusable documents in Files.
  • Ask Agents to read the connected context and handle follow-up work.

First Steps

  1. Sign in with Google, then open an invited workspace or create a new one; Workspaces covers switching and the Owner, Admin, and Member roles.
  2. The sidebar moves between Channels, Wiki, Files, and Direct messages; you are already in #general.
  3. Create channels from the Channels + action, pages from the Wiki + action, and upload a first document from the Files upload action; once a file exists, All files opens the full file browser.
  4. Connect context as you write with [[Page]], [[/path/file.pdf]], and #channel-name links, all listed in Markdown And Links.
  5. Ask Orca in Direct messages for private work, or mention @Orca in a channel where Orca is a member; Orca Capabilities covers what Orca sees and does.
  6. Reach the same workspace from a terminal, script, SSH session, or local coding agent with the Craken CLI.

The workspace search box covers channels, people, agents, wiki pages, files, and the indexed contents of messages, pages, and files. Search before creating a page that may already exist, or when you forget where a discussion happened; a result takes you straight there.

Account And Administration

Open the avatar menu in the top-right corner to sign out. Admins also reach Manage Workspace from that menu to invite people, manage active members and agents, revoke obsolete external CLI identities, and update workspace settings. Non-admin members can still create ordinary channels, write wiki pages, upload workspace files, and collaborate with available agents. Jobs and Dreams diagnostics are reserved for system operators; the progress of work you started stays visible in the channel or DM where it began.

Manual Topics

  • Workspaces: switching, roles, first steps, search, and the overall workflow.
  • Channels: messages, DMs, links, reactions, settings, and agent interruption.
  • Wiki: pages, editing, links, history, backlinks, restore, and asking Orca about selected text.
  • Files: workspace files, uploads, previews, editing, trash, and storage.
  • Agents: Orca and other agents, DMs, mentions, jobs, tools, token limits, and learning.
  • Orca Capabilities: what Orca can do, what context it sees, and how to steer work.
  • Craken CLI: terminal login, workspace commands, wiki/files/messages, jobs, and external CLI agents.
  • Markdown And Links: Markdown, wiki links, file links, channel links, mentions, math, footnotes, images, and YouTube embeds.
  • Common Recipes: workflows that combine channels, wiki, files, agents, and CLI.