CognoWorkspace settings control the identity, access, memory, imports, API keys, workers, and recent activity for one Cogno workspace.
Open settings
- Open the Cogno app.
- Select a workspace.
- Use the left sidebar and open Settings.
The settings sidebar contains General, Members, Memory, API Keys, Workers, and Activity.
General
Use General for workspace-level controls.
| Control | What it changes |
|---|---|
| Icon | Upload, crop, generate, or remove the workspace icon. |
| Name | Rename the workspace. |
| Task import | Drop one or more task CSV files and open column mapping. |
| Demo reset | Resets demo workspaces only. |
| Delete workspace | Permanently deletes workspace data after title confirmation. |
Workspace icon
Click the workspace icon to upload an image, generate an icon, or remove the current icon. Uploaded images open a crop dialog before saving.
Workspace name
Rename the workspace from the name form. The save action is available when the draft differs from the current workspace name.
Task import
Drop CSV files into Task import, or choose them from your computer. Cogno opens a review dialog before creating tasks.
Use Import task CSVs into Cogno when preparing CSVs.
Delete workspace
Deleting a workspace is permanent. The confirmation dialog requires the exact workspace title. Deletion removes notes, chat history, members, and workspace data.
Members
Use Members to invite and review workspace members.
| Action | Use it for |
|---|---|
| Invite | Open invite options. |
| Copy invite link | Create and copy a workspace invite link. |
| Add existing members | Add people from your other workspaces. |
| Edit | Remove eligible non-owner user members. |
The Edit action is available for workspace owners when there is at least one removable member. Owners and agent members are not removed through this list.
Memory
Use Memory for the workspace-wide summary that Cogno reads when it wakes.
| Action | Use it for |
|---|---|
| Edit | Switch from preview to Markdown editing. |
| Save | Persist changed memory. |
| Revert | Reset the draft to the last saved memory. |
| Preview | Leave edit mode and show rendered Markdown. |
Write durable facts, not temporary task status. Good memory content includes product scope, team responsibilities, naming rules, canonical links, and operating constraints.
API Keys
Use API Keys to create and revoke worker tokens for the current workspace.
| Property | Current behavior |
|---|---|
| Scope | worker |
| Raw key visibility | Shown once after creation. |
| Prefix | Listed later as cogno_wk_<prefix>.... |
| Limit | 25 active keys per user per workspace. |
| Revoke behavior | Immediate and irreversible. |
See API keys for the full setup path.
Workers
Use Workers to monitor CLI worker liveness and recent agent work.
| Area | Meaning |
|---|---|
| Workers | Registered CLI workers and online state. |
| Agent work | Recent dispatched work items. |
| Refresh | Reload worker or work item state. |
Workers register when the root cogno worker daemon is running. Liveness is based on heartbeat. A worker that stops reporting within two minutes shows as stale, then offline.
Activity
Use Activity to review recent task changes in the workspace.
Each event shows the actor, task change type, task title, and timestamp. Empty activity means no task events have been recorded yet.
Choosing the right settings page
| Goal | Go to |
|---|---|
| Rename the workspace | General |
| Change the workspace icon | General |
| Import task CSVs | General > Task import |
| Invite teammates | Members |
| Store stable workspace context | Memory |
| Create a CLI worker token | API Keys |
| Check worker liveness | Workers |
| Review recent task changes | Activity |
| Delete the workspace | General > Danger Zone |
Operational notes
- Invite members before importing CSV assignees.
- Keep Memory readable as standalone Markdown.
- Copy API keys immediately after creation.
- Revoke unused API keys.
- Check Workers after starting the root
cognoworker daemon. - Use Activity when checking whether imported or edited tasks were recorded.
LLM handoff
When asking an assistant to diagnose a workspace setting, provide:
- Workspace ID or workspace name.
- Settings page name.
- Action attempted.
- Visible error text.
- Whether the user is a workspace owner.
Use Copy for LLM when you want to pass this settings reference together with the exact page names.