How to: IDE and AI agent integration

Use this page to choose the editor and AI agent setup guide for contributing to the Pi-hole snap. Canonical Workshop is the supported execution environment for project commands. For command and task lookup details, see Workshop actions and agent workflows.

Start with the guide for the editor that will open the snap-pi-hole checkout.

Each editor guide covers the Linux development environment, repository clone, workspace opening steps, Workshop launch sequence, and the Workshop: Shell task.

After Workshop is launched and Workshop: Doctor passes, configure the AI agent workflow:

1. Read Configure AI agent workflows.
2. Choose Workshop terminal mode or native panel mode.
3. Provide model access and agent surface details before asking an agent to assign roles.
4. Use Workshop terminal mode for command-running implementers.

Use Workshop actions and agent workflows to look up:

• Workshop lifecycle commands
• Project actions
• VS Code and Zed task names
• .agents/ policy and template files
• Role assignment rules
• Verification commands