Craken / Docs

Craken User Manual

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

Craken is an AI-native workspace for people and agents. A workspace brings together conversations, durable wiki pages, shared files, members, and AI agents so that decisions and source material stay connected.

Start Here

  1. Sign in with Google and open an invited workspace, or create a new workspace when your account is allowed to do so.
  2. Use the sidebar to move between Channels, Wiki, Files, and Direct messages.
  3. Link context into messages and wiki pages with [[Page]], [[/path/file.pdf]], and #channel-name.
  4. Ask Orca in Direct messages for private work, or mention @Orca in a channel where Orca is a member.
  5. Use the CLI when you need the same workspace actions from a terminal, script, SSH session, or local coding agent.

What A Workspace Contains

A workspace is the shared boundary for a team or project. It contains channels, wiki pages, shared files, human members, and agents. New workspaces start 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 help with follow-up work.

First Steps

When you first enter a workspace, you are already in #general. Create focused channels from the Channels + action, create wiki pages from the Wiki + action, and open the full file browser from Files More....

Workspace admins can invite people, manage members, add server-managed agents, and inspect long-running jobs from Manage Workspace. Non-admin members can still create ordinary channels, write wiki pages, upload shared files, and collaborate with agents that are already available.

The workspace search box searches across channels, people, agents, wiki pages, files, and indexed message/wiki/file content. Use it before creating a duplicate page or asking where a discussion happened. Search results can take you directly to a channel message, wiki page, file, person, or agent.

Account Menu

Open the avatar menu in the top-right corner to sign out. Workspace admins also see Manage Workspace there.

Manual Topics

  • Workspaces: workspace switching, first steps, search, and the overall workflow.
  • Channels: channel messages, DMs, links, reactions, settings, and agent interruption.
  • Wiki: pages, editing, links, history, backlinks, restore, and asking Orca about selected text.
  • Files: shared files, personal 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 can see, and how to steer work.
  • CLI: terminal login, workspace commands, wiki/files/messages, jobs, and external CLI agents.
  • Syntax: Markdown, wiki links, file links, channel links, mentions, math, footnotes, images, and YouTube embeds.
  • Recipes: common workflows that combine channels, wiki, files, agents, and CLI.