Skip to content

OAC Package Refactor: Multi-IDE CLI with Community Registry #206

@darrenhinde

Description

@darrenhinde

Overview

Transform @nextsystems/oac into a comprehensive CLI package manager with multi-IDE support and community component sharing (shadcn-like).

Goals

  • ✅ Multi-IDE support (OpenCode, Cursor, Claude Code, Windsurf)
  • ✅ Flexible configuration for agent behavior and permissions
  • ✅ Community component registry (agents, skills, contexts)
  • ✅ Context file location flexibility
  • ✅ Version management and updates
  • ✅ Backward compatibility

Key Features

1. Multi-IDE Support

oac install opencode
oac install cursor
oac apply --all

2. Configuration System

oac configure
oac configure set agents.permissions.bash auto

3. Community Registry (shadcn-like)

oac add agent:rust-specialist
oac add https://github.com/user/oac-component
oac publish ./my-agent
oac browse agents

4. Context Flexibility

  • Support multiple context locations
  • Priority-based resolution
  • Auto-discovery

5. Version Management

oac update --check
oac update --claude --global

Implementation Phases

Phase 1: Core CLI Infrastructure (Week 1)

  • Set up TypeScript project
  • Configuration system
  • Basic commands (init, configure, list)

Phase 2: Registry & Components (Week 2)

  • Registry loader/resolver
  • Component installer
  • Profile installer

Phase 3: IDE Adapters (Week 3)

  • Integrate compatibility layer
  • IDE-specific installers
  • Apply command

Phase 4: Update System (Week 4)

  • Version checker
  • Update fetcher/applier
  • Update command

Phase 5: Context System (Week 5)

  • Context locator service
  • Multi-location resolution
  • Validation

Phase 6: Community Registry (Week 6)

  • Component package format
  • Add/publish commands
  • Search/browse functionality

Phase 7: Polish & Docs (Week 7)

  • Error handling
  • UX improvements
  • Documentation
  • npm publish

Technical Stack

  • Commander.js (CLI framework)
  • Zod (validation)
  • Inquirer (prompts)
  • TypeScript
  • Vitest (testing)

Context File

See .opencode/context/openagents-repo/features/oac-package-refactor.md for full details.

Branch

feature/oac-package-refactor

Success Criteria

  • Multi-IDE installation works
  • Configuration persists across sessions
  • Updates work across all IDEs
  • Community components can be added/published
  • Context resolution from multiple locations
  • Backward compatible with existing workflows
  • Published to npm as v1.0.0

Related Issues

Metadata

Metadata

Assignees

Labels

enhancementNew feature or requestfeatureNew feature or enhancement

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions