Asana board
An unreleased integration that brings your Asana tasks into Omniscio as a sidebar board: connecting it with a personal access token and a workspace id, the inbox rows for tasks assigned to you, and the workflow trigger and CLI routes it exposes.
On this page
Status: in development. Gated via the
asana-boardunreleased-feature registry (asanaBoardEnabledtoggle in Settings → Lab, orAMC_SHOW_ASANA_BOARD=1). The sidebar row appears once enabled.
What it is
A first-party Omniscio integration that brings your Asana tasks into the app so you can manage work without opening Asana's website. It surfaces as an "Asana" row in the projects sidebar (plugin tier) that will open a board view.
It is gated through the unreleased-feature registry (asana-board) — invisible
until a developer flips its status to shipped in unreleased-features.ts.
Where to find it
How to use it
- Enable it: Settings → Lab → toggle Asana board on. An "Asana" row appears in the sidebar.
- Connect: open the Asana sidebar row and enter your credentials:
- Personal Access Token — create one at app.asana.com → My Settings → Apps → Developer apps → Personal access tokens
- Workspace GID — the numeric workspace identifier from your Asana URL
- Credentials are saved encrypted at rest (listed in
ENCRYPTED_APP_SETTINGS_KEYS).
Inbox integration: turn on "Asana tasks assigned to me in Inbox" in
Settings → Lab. Omniscio then checks Asana in the background (every few minutes,
only while on) and surfaces your assigned, incomplete tasks as rows in the
unified Inbox. When a task updates, its row pops back to the top. Click a
row to view it; snooze or dismiss like any inbox item. Requires the Asana board
enabled and connected. Kill switch: AMC_DISABLE_ASANA_INBOX_POLL=1.
Workflow trigger: Asana tasks can trigger workflow automations. Events:
created, completed, updated. Poll interval: 2 minutes. Kill switch:
AMC_DISABLE_ASANA_WORKFLOW_TRIGGER=1.
CLI routes:
POST /asana/move-to-section— move a task to a different sectionPOST /asana/reorder— reorder a task within its sectionGET /asana/status,/asana/workspaces,/asana/workspaces/:workspaceGid/projects,/asana/projects/:projectGid,/asana/projects/:projectGid/sections,/asana/projects/:projectGid/tasks,/asana/tasks/:taskGid,/asana/tasks/:taskGid/comments,/asana/search— read-only, so an agent (Omni included) can find a task before it moves one. They take the full-trust token or a Mission Control host (Omni) session's own token, never reach a cloud box, and answer a plain "Asana is not connected"400instead of an empty list → integrations.md
How it behaves
Once the feature is enabled and your token and workspace id are saved, an Asana row appears in the sidebar and opens a board view of your tasks. The board panel itself is not implemented yet, so today the live surfaces are the inbox rows and the workflow trigger: Asana is checked in the background every few minutes, only while the inbox toggle is on, and a task that updates pops back to the top of your inbox. The limit worth knowing before you rely on this is that it is an unreleased feature behind the Lab gate — nothing is visible, and nothing polls, until it is turned on.
Troubleshooting
Each message below is the exact copy the app shows.
- "Your Asana access token is invalid or expired. Check Settings to reconnect." — Asana refused the token (a 401 or 403). Create a new personal access token at app.asana.com → My Settings → Apps → Developer apps → Personal access tokens and save it again with the workspace GID.
- "Asana is rate-limiting requests — wait a moment and try again." — wait, then retry.
- "The Asana resource was not found. It may have been deleted or moved." — the task the app asked for no longer exists at that address; reopen it from the board or your inbox.
- "Couldn't reach Asana — check your connection and try again." — the request never got an answer: offline, a proxy, or an Asana outage.
- "Something went wrong talking to Asana. Please try again." — the catch-all for any other response. Nothing was changed; retry.
Related
- jira-board.md — the closest analog; same architecture pattern.
- Contract:
.claude/memory/contracts/asana-integration-contract.md— the invariants and the tests that lock them.
Last verified 2026-10-06