Use these recipes when a task crosses several Craken surfaces.
Ask Orca
For private work, open Direct messages to Orca. For shared work, mention @Orca in a channel where Orca is a member. Include relevant [[wiki page]], [[/shared-file]], and #channel links.
See Agents.
Preserve A Decision
Discuss in a channel, then create or update a wiki page with the decision, evidence, owner, and next step. Link the source files and channel discussion from that page. Share the wiki link back in the channel.
Cite A File
Upload the file to Shared files, then link it from a message or wiki page with [[/path/file.ext]]. Use an alias when the file name is not readable: [[/briefs/q2.pdf|Q2 brief]].
See Files.
Use Craken From A Terminal
Install the CLI, log in, then use the command family for the surface you need:
craken auth login
craken help
craken workspace list
See CLI.
Make Codex Or Claude Code Participate
Create an external CLI agent profile:
craken auth login --as-agent --workspace WORKSPACE_ID --agent-name "Codex Research" --client-kind codex --profile codex-research
Use that profile for messages and workspace actions. The participant writes as the named agent, but it is not automatically wakeable like Orca.
Find Where Something Was Discussed
Use workspace search first. Search messages, wiki pages, files, and participants before creating a new page or asking others to repeat context.
See Workspaces.