The VS Code extension

The AperioFlow extension for Visual Studio Code (version 1.85 or later) puts your monitors and projects in the editor's sidebar.

Install the extension

Install it from the .vsix file: in VS Code open the Extensions view, choose the ... menu, then Install from VSIX..., and pick the AperioFlow file.

Sign in with an API key

1. Make an API key under Your account, API keys in AperioFlow, signed in as yourself (see The API and AI assistants). Choose the Member role to change tasks, or Viewer to look only.
2. In VS Code open the AperioFlow view in the Activity Bar and choose Sign in to AperioFlow (or run AperioFlow: Sign in from the Command Palette).
3. Confirm the AperioFlow address (https://app.aperioflow.co.uk) and paste the AperioFlow API key.

The key is kept in VS Code's secret storage, never in your settings, and is sent only to the address you gave. AperioFlow: Sign out removes it from your computer; it still exists in AperioFlow until you revoke it there.

The three panes

• Statuses: "All systems up" or how many are down, and a line for each monitor with its state. It refreshes while it is open.
• Projects: your projects, with their phases, tasks and subtasks. Filter by status and Find in projects (names, task keys and owners) narrow the tree; Clear the filter shows everything again.
• Messages: the comments on the task or subtask you pick, with a box to write one (Ctrl+Enter sends).

Change a task's status

Choose the pencil on a task or subtask (or right-click it and choose Change status (with a note)), pick the new status, and optionally type what changed or why. The note is saved as a comment on the task. A phase's status follows its tasks, so it cannot be changed here.

Right-click any item and choose Open in AperioFlow to open its project in the browser.

Settings

Changes made from VS Code show in the activity log as your name "via" the key's label.