agent-foundation

CLI que instala convenciones personales de trabajo para agentes de IA (AGENT_FOUNDATION.md) en las instrucciones globales de Claude Code, Codex, OpenCode y Pi Agent. Una sola fuente de verdad para convenciones de código, commits, estructura de proyectos y documentación — aplicada de forma idempotente en todos los hosts.

Instalación interactiva

npx -y @hugo.bastidas/agent-foundation

Muestra un menú para elegir la acción y los hosts:

    ,_,
   (O,O)
   (   )
    " "
  agent-foundation v0.2.0
  Install your AI agent conventions

  ◆ Choose an action
  │  ● Install
  │  ○ Remove
  │  ○ Status
  │  ○ Exit

  ◆ Target hosts (space to select, enter to confirm)
  │  ◻ Claude Code
  │  ◻ Codex
  │  ◻ OpenCode
  │  ◻ Pi Agent

Uso no-interactivo

# instalar en todos los hosts
npx -y @hugo.bastidas/agent-foundation install

# instalar solo en hosts específicos
npx -y @hugo.bastidas/agent-foundation install --host claude,codex

# ver estado
npx -y @hugo.bastidas/agent-foundation status

# desinstalar
npx -y @hugo.bastidas/agent-foundation remove --host all

Qué hace

Por cada host seleccionado:

1. Escribe AGENT_FOUNDATION.md (las convenciones) junto al archivo de instrucciones globales del host.
2. Inyecta un bloque gestionado con una @referencia al inicio de las instrucciones globales, preservando el contenido existente.

| Host | Instrucciones globales | |---|---| | Claude Code | ~/.claude/CLAUDE.md | | Codex | ~/.codex/AGENTS.md | | OpenCode | ~/.config/opencode/AGENTS.md | | Pi Agent | ~/.pi/agent/AGENTS.md |

La operación es idempotente: re-ejecutar install actualiza el bloque sin duplicarlo. remove elimina el bloque y el sidecar dejando intacto el resto del archivo.

Desarrollo

npm install
npm run build   # esbuild + tsc
npm test

Las convenciones viven en AGENT_FOUNDATION_INSTRUCTIONS en src/foundation.ts — edita ahí y re-ejecuta install para propagar.