Files
.vscode.d/AGENTS.md
Jim Myhrberg 43e54612b4 refactor(agents): rewrite AGENTS.md for concision and progressive disclosure
Verbose descriptions and architecture sections duplicated info easily
gleaned from the code itself. Replaced with a compact format covering
key commands, conventions, and scope — including a note that AI agent
configs live in a separate repo (jimeh/agentic).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 10:18:37 +00:00

1.7 KiB

AGENTS.md

Unified VSCode configuration repo — manages settings, keybindings, extensions, and tool configs for multiple VSCode-compatible editors via symlinks.

Key Commands

./siren <editor> config             # Symlink config files to editor
./siren <editor> extensions         # Install extensions from lock file
./siren <editor> extensions --latest # Install latest extension versions
./siren <editor> dump-extensions    # Export installed extensions to lock file
make all-config                     # Configure all editors
make all-extensions                 # Install extensions for all editors

Supported Editors

antigravity (agy, a), cursor (c), kiro (k), vscode (code, vsc, v), vscode-insiders (vsci, i), windsurf (surf, w)

Conventions

  • Config files are symlinked from this repo into each editor's config dir. The siren script handles backup and linking per OS (macOS/Linux).
  • Extension lock files (extensions.<editor>.lock) pin versions in publisher.name@version format. Dual registry: OpenVSX primary, VS Marketplace fallback, .vsix download as last resort.
  • settings.json and keybindings.json are large files (~1200+ lines each) organized with // MARK: comment sections. Search for MARK: to navigate.
  • Keybindings follow Emacs conventions — heavy use of ctrl+x and ctrl+c chord prefixes.
  • Siren script (bash): uses set -o pipefail, requires bash 4+ (assoc arrays), depends on jq and curl. Functions use snake_case.

Scope

AI agent configurations (CLAUDE.md, commands, skills, cursor rules) are managed in a separate repo (jimeh/agentic). This repo only handles editor settings, keybindings, extensions, and tool configs (cspell, harper-ls, MCP).