Powerred Apps — VS Code Extension

Features

A platform for first-party apps that extend GitHub Copilot Chat with real tools.

🔧

Native Copilot Tools

Built on the VS Code LM Tools API — no MCP overhead, no sidecar servers. Tools register directly into Copilot Chat.

📄

First-class Confluence

51 tools covering pages, drafts, spaces, comments, attachments, templates, properties, labels, restrictions, search, local mirror, and more.

🧠

Bundled Skills

Auto-deploys reference documentation to ~/.copilot/skills/ so Copilot always has up-to-date tool knowledge.

🔒

Privacy-first

Zero telemetry, zero analytics. Authentication tokens stored exclusively in VS Code's encrypted SecretStorage.

📋

Local Templates

File-based page templates with YAML frontmatter, variable substitution, and Confluence label sync. Global + workspace scopes.

🧰

Dev Team Tools

Export pages, diff versions, and bulk create/update/delete/move — all from Copilot Chat with controlled concurrency.

🚀 Install

Get started in seconds.

1

From Marketplace

Search powerred-apps in VS Code Extensions panel, or visit the Marketplace page

2

From CLI

code --install-extension allansantos-dv.powerred-apps

3

From VSIX

Download the .vsix from GitHub Releases and install manually

💡 Tip: After installing, open Copilot Chat and type @confluence to start using the Confluence tools.

🛠️ Confluence Tools

51 tools organized by category — all available as native Copilot Chat tools.

📄 Pages

confluence_get_page Get Page

confluence_search Search (CQL)

confluence_create_page Create Page

confluence_update_page_full Update Page (Full)

confluence_update_page_smart Update Page (Smart Merge)

confluence_list_pages List Pages

confluence_get_page_tree Get Page Tree

confluence_delete_page Delete Page

📝 Drafts

confluence_create_draft Create Draft

confluence_update_draft Update Draft

confluence_get_draft Get Draft

confluence_publish_draft Publish Draft

confluence_discard_draft Discard Draft

confluence_list_drafts List Drafts

🌐 Spaces

confluence_list_spaces List Spaces

confluence_get_space Get Space

confluence_create_space Create Space

confluence_update_space Update Space

confluence_delete_space Delete Space

🔍 Discovery & Personal

confluence_list_recents List Recents

confluence_list_favorites List Favorites

confluence_toggle_favorite Toggle Favorite

confluence_clear_recents Clear Recents

🏷️ Metadata

confluence_manage_page_labels Manage Page Labels

confluence_manage_page_properties Manage Page Properties

confluence_page_restrictions Page Restrictions

confluence_page_versions Page Versions

confluence_manage_folder Manage Folder

💬 Comments

confluence_footer_comments Footer Comments

confluence_inline_comments Inline Comments

📎 Attachments

confluence_list_attachments List Attachments

confluence_get_attachment Get Attachment

confluence_upload_attachment Upload Attachment

confluence_delete_attachment Delete Attachment

🔐 Permissions & Content Nodes

confluence_manage_space_permissions Space Permissions

confluence_manage_content_node Whiteboards, Databases, Embeds

🧰 Dev Team

confluence_export_page Export Page

confluence_diff_page_versions Diff Versions

confluence_bulk_pages Bulk Operations

📋 Templates

confluence_template_save Save Template

confluence_template_list List Templates

confluence_template_get Get Template

confluence_template_delete Delete Template

confluence_template_pull Pull from Confluence

confluence_template_render Render Template

🇬🇧 English

🔑 Confluence Authentication

Powerred Apps uses a hybrid auth model: OAuth 3LO for most operations, with an optional Cloud API token for a handful of legacy endpoints.

Recommended

OAuth 3LO

Non-expiring (refresh tokens rotate automatically, valid for 90 days of inactivity)
Browser-based setup — no manual token copying
Covers 45 of 45 tools for read + most writes via the Atlassian v2 gateway

Optional

Cloud API Token

Required only for the 10 tools that use v1 REST endpoints (no OAuth gateway)
Expires after 30 days of non-use
If you only use v2 tools, OAuth alone is enough

Tools that require Cloud API Token

Method	Description
`searchCql`	CQL search
`listDraftsV2`	List drafts (v2 rejects `status=draft`)
`createSpace`	Create space
`updateSpace`	Update space
`deleteSpace`	Delete space
`addPageLabels`	Add labels to page
`removePageLabel`	Remove label from page
`getContentRestrictions`	Get page restrictions
`getContentRestrictionsByOp`	Get restrictions by operation
`updateContentRestrictions`	Update page restrictions

Setup Steps

Run the command: Powerred Apps: Configure Confluence
Provide your Atlassian site URL (e.g., https://yoursite.atlassian.net)
A browser window opens for OAuth — sign in and approve the requested scopes
(Optional) Provide your email + Cloud API token if you need the 10 v1 tools above.
Generate a token at id.atlassian.com → API tokens

Status check: Run Powerred Apps: Check Confluence Auth Status to see which credentials are configured and valid.

Token rotation: OAuth refresh tokens rotate on every refresh and remain valid for 90 days of inactivity. Cloud API tokens expire after 30 days of non-use.

🔒 Security: All credentials are stored in VS Code SecretStorage (encrypted at rest). They are never sent anywhere except api.atlassian.com and your Atlassian tenant.

🇧🇷 Português

🔑 Autenticação do Confluence

O Powerred Apps usa um modelo híbrido de autenticação: OAuth 3LO para a maioria das operações, com um Token de API Cloud opcional para alguns endpoints legados.

Recomendado

OAuth 3LO

Não expira (tokens de atualização rotacionam automaticamente, válidos por 90 dias de inatividade)
Configuração via navegador — sem cópia manual de tokens
Cobre 45 de 45 ferramentas para leitura + maioria das escritas via gateway v2 da Atlassian

Opcional

Token de API Cloud

Necessário apenas para as 10 ferramentas que usam endpoints REST v1 (sem gateway OAuth)
Expira após 30 dias sem uso
Se você usa apenas ferramentas v2, OAuth sozinho é suficiente

Ferramentas que exigem Token de API Cloud

Método	Descrição
`searchCql`	Busca CQL
`listDraftsV2`	Listar rascunhos (v2 rejeita `status=draft`)
`createSpace`	Criar espaço
`updateSpace`	Atualizar espaço
`deleteSpace`	Excluir espaço
`addPageLabels`	Adicionar rótulos à página
`removePageLabel`	Remover rótulo da página
`getContentRestrictions`	Obter restrições da página
`getContentRestrictionsByOp`	Obter restrições por operação
`updateContentRestrictions`	Atualizar restrições da página

Passos de Configuração

Execute o comando: Powerred Apps: Configurar Confluence
Informe a URL do seu site Atlassian (ex.: https://seusite.atlassian.net)
Uma janela do navegador abre para OAuth — faça login e aprove os escopos solicitados
(Opcional) Informe seu email + Token de API Cloud se precisar das 10 ferramentas v1 acima.
Gere um token em id.atlassian.com → API tokens

Verificação de status: Execute Powerred Apps: Verificar Status de Autenticação do Confluence para ver quais credenciais estão configuradas e válidas.

Rotação de tokens: Tokens de atualização OAuth rotacionam a cada refresh e permanecem válidos por 90 dias de inatividade. Tokens de API Cloud expiram após 30 dias sem uso.

🔒 Segurança: Todas as credenciais são armazenadas no SecretStorage do VS Code (criptografadas em repouso). Nunca são enviadas para outro lugar além de api.atlassian.com e seu tenant Atlassian.

🔒 Privacy Policy

Powerred Apps is designed with privacy as a core principle.

Data Collection

Powerred Apps collects ZERO personal data. No telemetry, no analytics, no tracking.

Local Storage

Authentication tokens (Atlassian API token, OAuth tokens, PAT) are stored exclusively in VS Code's encrypted SecretStorage. Never transmitted anywhere except the user's configured Atlassian instance.

Network

Outbound requests are made ONLY to:

The user-configured Atlassian Cloud or Data Center instance for tool execution
auth.atlassian.com and api.atlassian.com if OAuth is enabled

No third-party servers, no proxies, no analytics endpoints.

Atlassian Data

Page content, space data, and comments retrieved during tool execution are passed to GitHub Copilot Chat for the user's request. The extension does not persist Atlassian content beyond the active chat session.

Telemetry

None. The extension does not send usage data, error reports, or any signals to the publisher or any third party.

Open Source

Source code available at github.com/AllanSantos-DV/powerred-apps (private; release artifacts public via Marketplace).

Contact

Issues, questions, data requests: open an issue on GitHub.

Updates

This Privacy Policy may be updated; the current version is always at allansantos-dv.github.io/powerred-apps/#privacy. Last updated: April 27, 2026.