docs: document Pi agent integration

Author: codeaholicguy

web/content/docs/8-agent-management.md

@@ -29,8 +29,18 @@ To use the `agent open` command, your environment must meet these requirements:
 
 AI DevKit detects active sessions from the following tools:
 
-- **Claude Code**: Automatically detects running `claude` processes and correlates them with your active projects.
-- **Codex**: Detects running Codex sessions and exposes the same list, open, send, and detail workflows.
+- **[Claude Code](https://www.claude.com/product/claude-code)**: Automatically detects running `claude` processes and correlates them with your active projects.
+- **[Codex](https://chatgpt.com/en-SE/features/codex)**: Detects running Codex sessions and exposes the same list, open, send, and detail workflows.
+- **[Gemini CLI](https://geminicli.com/)**: Detects running Gemini CLI sessions and exposes them through the same agent management commands.
+- **[GitHub Copilot](https://github.com/features/copilot)**: Detects running Copilot coding agent sessions and exposes them through the agent list, detail, and send workflows.
+- **[OpenCode](https://opencode.ai/)**: Detects running OpenCode sessions and exposes them through the same agent management commands.
+- **[Pi](https://pi.dev/)**: Detects Pi sessions. For more accurate Pi integration, install the [`@ai-devkit/pi-session-tracker`](https://pi.dev/packages/@ai-devkit/pi-session-tracker) package inside Pi:
+
+  ```bash
+  pi install npm:@ai-devkit/pi-session-tracker
+  ```
+
+  The tracker gives AI DevKit better session information than process detection alone.
 
 ## Commands
 

web/content/faq/ai-devkit-pi-integration.md

@@ -0,0 +1,58 @@
+---
+title: AI DevKit Pi Integration
+description: How to improve AI DevKit's Pi session detection with the @ai-devkit/pi-session-tracker package.
+order: 12
+---
+
+AI DevKit can detect Pi sessions through its agent management system. For the most accurate Pi integration, install the dedicated Pi session tracker package:
+
+```bash
+pi install npm:@ai-devkit/pi-session-tracker
+```
+
+Package page: https://pi.dev/packages/@ai-devkit/pi-session-tracker
+
+## What does the Pi session tracker do?
+
+`@ai-devkit/pi-session-tracker` helps AI DevKit identify active Pi sessions with better session metadata than process detection alone.
+
+This matters when you use commands such as:
+
+```bash
+ai-devkit agent list
+ai-devkit agent detail --id <pi-session>
+ai-devkit agent send "What are you working on?" --id <pi-session>
+```
+
+Without the tracker, AI DevKit may still detect Pi through local processes, but the result can be less precise.
+
+## When should I install it?
+
+Install it if you use Pi with AI DevKit agent management features, especially if you want AI DevKit to more reliably list, inspect, or message your active Pi sessions.
+
+## How do I install it in Pi?
+
+Run this from Pi:
+
+```bash
+pi install npm:@ai-devkit/pi-session-tracker
+```
+
+After installing, start or restart your Pi session, then check what AI DevKit can see:
+
+```bash
+ai-devkit agent list
+```
+
+## Does this replace AI DevKit setup?
+
+No. The Pi session tracker improves Pi session visibility for AI DevKit. You should still initialize AI DevKit in your project when you want skills, memory, workflow docs, or other AI DevKit project configuration:
+
+```bash
+ai-devkit init
+```
+
+## Where can I read more?
+
+- Pi package: https://pi.dev/packages/@ai-devkit/pi-session-tracker
+- AI DevKit Agent Management: https://ai-devkit.com/docs/8-agent-management