Getting Started

Install the plugin, complete first-time setup, and run your first session.

Install the Plugin

copilot plugin install https://community.opengroup.org/osdu/ui/ai-devops-agent/osdu-copilot-plugin.git

git clone git@community.opengroup.org:osdu/ui/ai-devops-agent/osdu-copilot-plugin.git
copilot plugin install ./osdu-copilot-plugin

Prerequisites

• Copilot CLI

The setup skill handles all additional dependencies and configuration. Just ask Copilot to help you get set up.

First-Time Setup

1. Enable Extensions

Extensions are currently experimental and must be enabled in Copilot CLI. In a Copilot session, press /, select extensions, and set the mode to Load & Augment. This only needs to be done once.

2. Run Setup

Ask Copilot to set up the plugin:

❯ help me get setup

The setup flow will:

1. Install extensions to ~/.copilot/extensions/ with npm dependencies
2. Check CLI tools and report what is missing by tier
3. Offer to install missing tools with user approval

3. Restart Copilot

After updating the plugin (copilot plugin update osdu-plugin), run setup again to pick up new or changed extensions.

Verify Installation

copilot

You should see the plugin loaded with its skills and agents:

● Environment loaded: ... plugins, skills, agents

Your First Session

With the plugin installed and setup complete, you are ready to go. Try a few prompts:

# Morning briefing with goal progress and activity
/gm

# Check what is happening across OSDU services
What pipelines are failing?
Show me my open MRs

# Clone an OSDU repo and scan dependencies
osdu, clone the partition service
osdu, scan partition dependencies

# Ship local changes with review and quality checks
/send

The briefing pulls your goals from the vault (if configured), checks GitLab for open MRs and pipeline failures, and recommends what to work on first.

Optional: Create a CIMPL Environment

If you need live OSDU platform access, infrastructure workflows, or environment health checks, create a CIMPL environment:

cimpl, create a cimpl environment

The @cimpl agent will:

1. Clone the cimpl-azure-provisioning repository to your workspace
2. Verify Azure authentication (az login and azd auth login)
3. Check for existing environments
4. Run azd up to provision the full stack (AKS, networking, OSDU services)

Provisioning takes 20-30 minutes, depending on your Azure setup.

Optional: Bootstrap the Brain

The brain vault is optional. Without it, skills still work; briefings print to the terminal, reports save to the working directory, and recommendations are based on session context only. When you are ready for persistent knowledge, initialize the vault and set up goals.

help me bootstrap my goals

Optional: QMD Vault Search

QMD enables hybrid search over your Obsidian vault. It is optional and currently available on macOS and Linux only. The plugin works without it, but vault search will not be available until QMD is installed and indexed.

# Install QMD globally
npm install -g @tobilu/qmd

# Index your vault after bootstrapping the brain
# Default vault location: ~/.osdu-brain (override with $OSDU_BRAIN)
qmd collection add ~/.osdu-brain --name brain
qmd embed

Reference: Extensions

The plugin ships with two Copilot CLI extensions that are installed to ~/.copilot/extensions/ during setup. Most users do not need to configure these directly.

OSDU Extension

The OSDU extension connects to a live OSDU platform using Keycloak client credentials. Configuration is auto-discovered from your workspace after creating an environment with the @cimpl agent.

# Switch between environments if you have multiple
azd env select <your-environment>

Or set environment variables manually: