Skip to content
Work IQ Dev Tools Preview · v0.20.0

    ↑↓ navigate ↵ open Esc close

    Work IQ Dev Tools are in preview (v0.20.0). Commands and APIs may change before 1.0. See the installation guide.

    Getting Started

    Getting Started with Work IQ Dev Tools

    Section titled “Getting Started with Work IQ Dev Tools”

    Welcome to Work IQ Dev Tools. This section walks you through installing the WIQD agentic experience or CLI, authenticating, and creating your first Microsoft 365 Copilot declarative agent.

    What are Work IQ Dev Tools?

    Section titled “What are Work IQ Dev Tools?”

    Work IQ Dev Tools provide agentic workflows and a developer CLI for building, validating, and publishing Microsoft 365 Copilot declarative agents.

    Where to Start

    Section titled “Where to Start”
    1. Installation — Choose marketplace-first agentic setup or the existing installation script.
    2. Quickstart — Create your first agent in 5 minutes.
    3. Authentication — Sign in to your Microsoft 365 account.
    4. Cookbooks — Build useful agents with end-to-end, outcome-focused recipes.

    Prerequisites

    Section titled “Prerequisites”
    • GitHub Copilot CLI or Claude Code for marketplace-first setup
    • Node.js 24+ for the installation-script path
    • A Microsoft 365 account with access to Copilot
    • An Azure subscription (for provisioning agents)

    Choose an installation path

    Section titled “Choose an installation path”

    Option 1: Install the marketplace plugin

    Section titled “Option 1: Install the marketplace plugin”

    GitHub Copilot CLI:

    copilot plugin install wiqd@awesome-copilot

    Or use the WIQD marketplace:

    copilot plugin marketplace add microsoft/wiqd
    copilot plugin install wiqd@wiqd

    Claude Code:

    claude plugin marketplace add microsoft/wiqd
    claude plugin install wiqd@wiqd

    Start a new host session and begin agentic authoring. This path does not install the wiqd CLI.

    Option 2: Use the installation script

    Section titled “Option 2: Use the installation script”

    Install the CLI and the components managed by the existing installer:

    Terminal window
    iex "& { $(irm 'https://aka.ms/wiqd/install.ps1') }"

    On macOS / Linux:

    Terminal window
    curl -fsSL https://aka.ms/wiqd/install.sh | bash

    Guided Experiences with --agent wiqd:wiqd

    Section titled “Guided Experiences with --agent wiqd:wiqd”

    Work IQ Dev Tools also ship a Copilot CLI agent. Once installed, you can drive the agent lifecycle conversationally in interactive mode by passing --agent wiqd:wiqd, which routes your request to the wiqd orchestrator for skill routing, lifecycle orchestration, and next-step suggestions:

    Terminal window
    copilot -i "create a new declarative agent" --agent wiqd:wiqd

    Always include --agent wiqd:wiqd so Copilot CLI targets the wiqd orchestrator rather than generic behavior.