Orkestra AI

Orkestra AI is a Visual Studio Code and Cursor extension that connects your editor to Jira, GitHub Issues, Azure DevOps, and ClickUp, and streamlines the path from task to pull request: refine work items, track progress on a board, run an opinionated delivery workflow, and use AI-assisted PR review with GitHub or Bitbucket Cloud.

Why Orkestra AI

• Unified board in the sidebar: see and act on tasks without leaving the editor.
• Multi-profile: several provider connections (tabs) with workspace ↔ profile linking.
• End-to-end workflow: refine → start → implement → review/fix PR → finish task.
• Code Review view: PR comments, repo-level “your open PRs”, and review tooling aligned with your Git remote.
• SCM-aware: GitHub and Bitbucket Cloud for PRs, comments, and activity (tokens via settings or active profile).

Installation

1. Open Extensions (Ctrl+Shift+X / Cmd+Shift+X).
2. Search for Orkestra AI. The marketplace identifier is DjAlexDee.orkestra-ai (publisher + . + name from package.json).
3. Click Install and reload the window if prompted.

Or install from a VSIX: Extensions → … → Install from VSIX….

Quick start

1. Open a folder (workspace) that contains your Git repository.
2. Click the Orkestra AI icon in the Activity Bar to open the Board webview.
3. Complete the setup wizard / Settings inside the board: add at least one provider profile (Jira, GitHub, Azure DevOps, or ClickUp).
4. Use Orkestra AI: Link Workspace from the Command Palette if you need to bind this folder to a board profile and repository context.
5. For PRs and Code Review, configure GitHub and/or Bitbucket credentials under devTaskAssistant.* (see Configuration).

Main features

Default keyboard shortcuts (when the editor has focus):

All commands are available under the Orkestra AI category in the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).

Supported task providers

• Jira Cloud — API token (basic) or OAuth (client id/secret, tokens, cloud id).
• GitHub — Personal access token for issues/projects as configured.
• Azure DevOps — PAT, organization, project.
• ClickUp — API token and list id.

Provider-specific fields live under devTaskAssistant.* in Settings.

GitHub & Bitbucket (pull requests)

• GitHub: devTaskAssistant.github.token (and optional owner/repo helpers). Used for PR search, comments, and activity.
• Bitbucket Cloud: devTaskAssistant.bitbucket.user and devTaskAssistant.bitbucket.token (App Password or OAuth).
  • OAuth tokens limited to repository + pull request scopes may not allow GET /2.0/user; the extension can still list your open PRs by combining credential username, git config user.name, and author metadata from the API.
• Legacy fallback: ~/.prc-config.json (bitbucket / github entries) when workspace settings do not define tokens.

Remote must be a supported host (github.com or bitbucket.org) for PR features tied to origin.

Configuration (overview)

Open Settings, search for Orkestra AI or devTaskAssistant.

Notable groups:

• Task providers: Jira, GitHub, Azure, ClickUp (profiles, domains, tokens).
• SCM: devTaskAssistant.github.*, devTaskAssistant.bitbucket.*.
• Review / auto-fix: devTaskAssistant.review.* (thresholds, batch commit, PR summary comment, toasts).
• API: devTaskAssistant.apiPort for the embedded HTTP API (tasks, billing hooks, etc.).
• Billing (optional): devTaskAssistant.billingEmail, devTaskAssistant.billingCpfCnpj when using Asaas integration.

Workspace link

Commands:

• Orkestra AI: Link Workspace
• Orkestra AI: Change Workspace Connection
• Orkestra AI: Unlink Workspace

They persist which board profile (and repository profile, when applicable) applies to the current workspace so the board and PR flows stay consistent.

Output channels (troubleshooting)

The extension writes to dedicated Output channels, for example:

• Orkestra — Code Review (Repo PRs) — traces for “your PRs in repository” (Bitbucket/GitHub).
• Orkestra AI, Orkestra AI Review, Orkestra AI Workflow, etc., for AI and pipeline diagnostics.

Use View → Output and pick the channel from the dropdown.

Requirements

• VS Code >= 1.80.0 (or a compatible Cursor build).
• Network access to your task provider and to GitHub/Bitbucket APIs when using PR features.
• A folder workspace for Git-based features (origin recommended).

Development

git clone https://github.com/djalexdee/orkestra-ai.git
cd orkestra-ai
npm install
npm run compile

Press F5 in VS Code to launch the Extension Development Host with this extension loaded.

Scripts:

• npm run compile — TypeScript build to out/
• npm run watch — watch mode
• npm run build:extension — compile + packaging helper (scripts/ensure-dist-output.mjs)

License

MIT — see LICENSE.md.

Links

• Visual Studio Marketplace: Orkestra AI
• Repository: github.com/djalexdee/orkestra-ai
• Issues & feature requests: use the GitHub Issues tab on the repository above.

If the marketplace page still shows an old title (e.g. a previous product name), update the display name and short description in the publisher management portal for this extension; those fields are not overridden by the README alone until you publish a new version and refresh listing metadata.

Nota em português

O Orkestra AI integra o VS Code/Cursor a ferramentas de tarefas e a GitHub/Bitbucket para você acompanhar o board, executar o fluxo (refinar → PR → review) e usar a aba Code Review no painel lateral. Após instalar, abra o ícone Orkestra AI na barra de atividades, configure os perfis em Configurações (devTaskAssistant) e, se necessário, use Orkestra AI: Link Workspace para associar a pasta do projeto ao perfil correto.