Quickstart - Copilot Goal System

Runtime: Node.js >= 20 and either GitHub Copilot CLI or VS Code Copilot Chat.

VS Code

Install from the VS Code Marketplace. After VS Code installs the extension, run:

Copilot Goal System: Install Recommended Setup

The Marketplace install button installs the VS Code wrapper. The command above installs the local goal system for your current OS account:

Copilot CLI stable adapter
VS Code Copilot Chat preview adapter
Copilot CLI MCP stdio server
local goal tools
lifecycle hooks
the Goal System custom agent

After extension updates, VS Code checks whether ~/.copilot/extensions/goal-system/ is older than the bundled runtime. If it is stale, the status bar switches to Goal Update and VS Code prompts you to update the local Copilot files.

Terminal

Install directly from the published docs site:

curl -fsSL https://gabrimatic.github.io/copilot-goal-system/install.sh | bash

Piped this way, install.sh downloads the repository archive to a temporary directory and runs the real installer from there. Install CLI, VS Code Chat, and MCP support:

curl -fsSL https://gabrimatic.github.io/copilot-goal-system/install.sh | bash -s -- --target all

Or clone the repository:

git clone https://github.com/gabrimatic/copilot-goal-system.git
cd copilot-goal-system
./install.sh

Reload Copilot

For CLI mode, restart Copilot CLI, then run:

/skills reload
/env

For MCP mode, run:

/mcp show goalSystem

For VS Code Chat, reload VS Code, then select the Goal System custom agent in Copilot Chat.

Start a goal

/goal
Make this project pass its test suite. Inspect first, fix every in-scope issue, verify with real evidence, and finish only after the completion audit passes.

​VS Code

​Terminal

​Reload Copilot

​Start a goal

VS Code

Terminal

Reload Copilot

Start a goal