sidekick-agent-hub: Instructions file for Codex

AGENTS.md

This file provides guidance to Codex and other coding agents when working with code in this repository. CLAUDE.md mirrors the same project guidance for Claude Code.

Project Overview

Sidekick Agent Hub is an AI coding assistant and project-intelligence toolkit with real-time agent monitoring. It ships as a VS Code extension and a terminal dashboard. Inference can run through Claude Max, Claude API, OpenCode, or Codex CLI; session monitoring reads Claude Code, OpenCode, or Codex session data.

The repo is a small monorepo:

• sidekick-vscode/ — VS Code extension, extension-host services, and webview source
• sidekick-shared/ — canonical provider, parser, persistence, quota, transcript, and schema library used by the extension and CLI; published as sidekick-shared
• sidekick-cli/ — Ink-based terminal dashboard and one-shot command suite; published as sidekick-agent-hub with the sidekick binary
• docs/, mkdocs.yml, assets/, images/ — documentation site content and assets
• scripts/ — cross-package build, lint, and version helpers

Build & Development Commands

Extension commands run from sidekick-vscode/:

npm run compile      # Dev build with source maps (esbuild)
npm run build        # Production build, minified
npm run watch        # Watch mode for development
npm test             # Run all tests (Vitest)
npm run test:watch   # Watch mode for tests
npm run lint         # ESLint check
npm run lint:fix     # ESLint auto-fix
npm run format       # Prettier write for this package
npm run format:check # Prettier check for this package
npm run package      # Create .vsix for distribution

Run a single test file: npx vitest run src/services/ModelResolver.test.ts (from sidekick-vscode/).

Press F5 in VS Code with sidekick-vscode/ open to launch the Extension Development Host.

Shared library commands run from sidekick-shared/:

npm run build        # tsc build to dist/
npm run clean        # Remove dist/
npm test             # Build, then run Vitest
npm run test:watch   # Watch mode for tests
npm run lint         # ESLint check
npm run lint:fix     # ESLint auto-fix
npm run format       # Prettier write for this package
npm run format:check # Prettier check for this package