From bf02ad0d5c7dce5f3d84dd9996774fe833665ecf Mon Sep 17 00:00:00 2001 From: Darren Hinde <107584450+darrenhinde@users.noreply.github.com> Date: Sun, 18 Jan 2026 09:31:35 +0000 Subject: [PATCH] refactor: Rename repository to OpenAgents Control (#100) * refactor: Rename repository to OpenAgents Control Update all project references from "OpenAgents" to "OpenAgents Control": - Updated core config files (package.json, registry.json) - Updated documentation (README.md, docs/) - Updated scripts (install.sh, update.sh, test scripts) - Updated agent and command files - Updated integrations and packages - Updated all GitHub URLs to use OpenAgentsControl Naming convention: - Display name: "OpenAgents Control" - Repository URL: OpenAgentsControl * feat: Enable subagent-to-subagent delegation (ContextScout integration) Allow coding-related subagents to call ContextScout for context discovery: - CoderAgent: Can now discover coding standards on-demand - TestEngineer: Can now discover test coverage and TDD guidelines - CodeReviewer: Can now discover code review and security patterns - BuildAgent: Can now discover build validation standards - DocWriter: Can now discover documentation formatting guidelines Changes per subagent: - Added `task: true` to tools section - Added permission allowlist for ContextScout only (deny all other delegation) - Added Context Discovery workflow section with when-to-call guidance This enables subagents to be self-sufficient for finding relevant standards instead of relying on orchestrator to provide all context files. Benefits: - Subagents can discover what they need when context isn't explicit - Maintains security (only ContextScout allowed via task tool) - Follows existing patterns (uses task tool like main agents) * fix: Set OPENCODE_BRANCH in CI tests to use PR branch for downloads - Add OPENCODE_BRANCH environment variable to E2E tests - Add OPENCODE_BRANCH environment variable to profile smoke tests - Ensures tests download files from the PR branch instead of main - Fixes E2E test failures after repository rename to OpenAgentsControl --- .github/PROJECT_CLI_GUIDE.md | 32 +++++----- .github/workflows/installer-checks.yml | 4 ++ .opencode/agent/meta/repo-manager.md | 6 +- .opencode/agent/subagents/code/build-agent.md | 29 ++++++++- .opencode/agent/subagents/code/coder-agent.md | 36 +++++++++-- .opencode/agent/subagents/code/reviewer.md | 27 ++++++++- .opencode/agent/subagents/code/tester.md | 30 ++++++++-- .../agent/subagents/core/contextscout.md | 2 +- .../agent/subagents/core/documentation.md | 26 +++++++- .opencode/command/commit-openagents.md | 2 +- .opencode/command/validate-repo.md | 6 +- .../examples/navigation-examples.md | 4 +- .../guides/organizing-context.md | 2 +- .opencode/context/core/navigation.md | 2 +- .../context/core/workflows/navigation.md | 2 +- .opencode/context/navigation.md | 2 +- .../openagents-repo/core-concepts/agents.md | 6 +- .../openagents-repo/core-concepts/registry.md | 2 +- .../examples/context-bundle-example.md | 4 +- .../guides/building-cli-compact.md | 4 +- .../guides/profile-validation.md | 2 +- .../context/openagents-repo/navigation.md | 4 +- .../context/openagents-repo/quick-start.md | 4 +- COMPATIBILITY.md | 10 ++-- README.md | 60 +++++++++---------- ROADMAP.md | 12 ++-- dev/docs/context-reference-convention.md | 4 +- docs/README.md | 20 +++---- docs/agents/repo-manager.md | 6 +- docs/contributing/ADDING_EVALUATOR.md | 2 +- docs/contributing/CONTRIBUTING.md | 2 +- docs/contributing/DEVELOPMENT.md | 10 ++-- docs/features/abilities-system/PLAN.md | 10 ++-- docs/features/system-builder/README.md | 4 +- docs/features/system-builder/quick-start.md | 6 +- .../QUICK_START_SYSTEM_BUILDER.md | 6 +- docs/getting-started/installation.md | 40 ++++++------- .../getting-started/platform-compatibility.md | 38 ++++++------ docs/github/GITHUB_SETTINGS.md | 2 +- evals/agents/meta/repo-manager/README.md | 2 +- install.sh | 14 ++--- integrations/claude-code/README.md | 55 ++++++++--------- .../converter/src/convert-agents.js | 24 ++++---- integrations/claude-code/install-claude.sh | 8 +-- package.json | 2 +- packages/plugin-abilities/README.md | 2 +- packages/plugin-abilities/package.json | 2 +- packages/plugin-abilities/test-plugin.ts | 2 +- registry.json | 12 ++-- scripts/README.md | 2 +- scripts/tests/README.md | 2 +- scripts/tests/test-compatibility.sh | 4 +- scripts/tests/test-non-interactive.sh | 2 +- update.sh | 6 +- 54 files changed, 360 insertions(+), 249 deletions(-) diff --git a/.github/PROJECT_CLI_GUIDE.md b/.github/PROJECT_CLI_GUIDE.md index 9ad639d..4493c70 100644 --- a/.github/PROJECT_CLI_GUIDE.md +++ b/.github/PROJECT_CLI_GUIDE.md @@ -1,6 +1,6 @@ # GitHub Project CLI Guide -Quick reference for managing your OpenAgents project board from the terminal. +Quick reference for managing your OpenAgents Control project board from the terminal. ## šŸš€ Quick Start @@ -37,7 +37,7 @@ make idea TITLE="Add support for Cursor" BODY="Extend the framework to work with **Using gh directly:** ```bash gh issue create \ - --repo darrenhinde/OpenAgents \ + --repo darrenhinde/OpenAgentsControl \ --title "Add eval harness for small OSS models" \ --body "Problem: Need to test agents with smaller models\n\nProposed solution: Create eval harness" \ --label "idea,agents,evals" @@ -49,28 +49,28 @@ gh issue create \ ```bash make ideas # or -gh issue list --repo darrenhinde/OpenAgents --label idea +gh issue list --repo darrenhinde/OpenAgentsControl --label idea ``` **View specific issue:** ```bash make issue-view NUM=123 # or -gh issue view 123 --repo darrenhinde/OpenAgents +gh issue view 123 --repo darrenhinde/OpenAgentsControl ``` **Comment on an idea:** ```bash make issue-comment NUM=123 COMMENT="Leaning towards X approach" # or -gh issue comment 123 --repo darrenhinde/OpenAgents --body "Great idea!" +gh issue comment 123 --repo darrenhinde/OpenAgentsControl --body "Great idea!" ``` **Close when done:** ```bash make issue-close NUM=123 # or -gh issue close 123 --repo darrenhinde/OpenAgents +gh issue close 123 --repo darrenhinde/OpenAgentsControl ``` ### Project Board Management @@ -92,9 +92,9 @@ make project-items **Add issue to project:** ```bash -make add-to-project ISSUE_URL=https://github.com/darrenhinde/OpenAgents/issues/123 +make add-to-project ISSUE_URL=https://github.com/darrenhinde/OpenAgentsControl/issues/123 # or -gh project item-add 2 --owner darrenhinde --url https://github.com/darrenhinde/OpenAgents/issues/123 +gh project item-add 2 --owner darrenhinde --url https://github.com/darrenhinde/OpenAgentsControl/issues/123 ``` --- @@ -118,7 +118,7 @@ make labels **Create new label:** ```bash -gh label create "priority-high" --repo darrenhinde/OpenAgents --color "d73a4a" --description "High priority" +gh label create "priority-high" --repo darrenhinde/OpenAgentsControl --color "d73a4a" --description "High priority" ``` --- @@ -146,13 +146,13 @@ gh project item-edit 2 \ **Create milestone:** ```bash gh milestone create "v0.2 - DX & Examples" \ - --repo darrenhinde/OpenAgents \ + --repo darrenhinde/OpenAgentsControl \ --description "Short-term focus on developer experience" ``` **Attach milestone to issue:** ```bash -gh issue edit 123 --repo darrenhinde/OpenAgents --milestone "v0.2 - DX & Examples" +gh issue edit 123 --repo darrenhinde/OpenAgentsControl --milestone "v0.2 - DX & Examples" ``` ### Bulk Operations @@ -160,14 +160,14 @@ gh issue edit 123 --repo darrenhinde/OpenAgents --milestone "v0.2 - DX & Example **Close multiple issues:** ```bash for i in 123 124 125; do - gh issue close $i --repo darrenhinde/OpenAgents + gh issue close $i --repo darrenhinde/OpenAgentsControl done ``` **Add label to multiple issues:** ```bash for i in 123 124 125; do - gh issue edit $i --repo darrenhinde/OpenAgents --add-label "priority-high" + gh issue edit $i --repo darrenhinde/OpenAgentsControl --add-label "priority-high" done ``` @@ -197,7 +197,7 @@ make issue-close NUM=42 ## šŸ”— Resources - **Project Board:** https://github.com/users/darrenhinde/projects/2 -- **Repository:** https://github.com/darrenhinde/OpenAgents +- **Repository:** https://github.com/darrenhinde/OpenAgentsControl - **GitHub CLI Docs:** https://cli.github.com/manual/ --- @@ -220,14 +220,14 @@ make issue-close NUM=42 ```bash # Save common queries as shell functions function oa-my-issues() { - gh issue list --repo darrenhinde/OpenAgents --assignee @me + gh issue list --repo darrenhinde/OpenAgentsControl --assignee @me } ``` 4. **Combine with git workflow:** ```bash # Create issue and branch in one go - ISSUE=$(gh issue create --repo darrenhinde/OpenAgents --title "Fix bug" --label bug --format json | jq -r .number) + ISSUE=$(gh issue create --repo darrenhinde/OpenAgentsControl --title "Fix bug" --label bug --format json | jq -r .number) git checkout -b "fix/issue-$ISSUE" ``` diff --git a/.github/workflows/installer-checks.yml b/.github/workflows/installer-checks.yml index 949a527..e582275 100644 --- a/.github/workflows/installer-checks.yml +++ b/.github/workflows/installer-checks.yml @@ -113,6 +113,8 @@ jobs: run: brew install jq || true - name: Run E2E tests + env: + OPENCODE_BRANCH: ${{ github.head_ref || github.ref_name }} run: bash scripts/tests/test-e2e-install.sh - name: Summary @@ -166,6 +168,8 @@ jobs: run: sudo apt-get install -y jq curl - name: Test ${{ matrix.profile }} profile + env: + OPENCODE_BRANCH: ${{ github.head_ref || github.ref_name }} run: | TEST_DIR="/tmp/profile-test-${{ matrix.profile }}" mkdir -p "$TEST_DIR" diff --git a/.opencode/agent/meta/repo-manager.md b/.opencode/agent/meta/repo-manager.md index be146eb..f440e51 100644 --- a/.opencode/agent/meta/repo-manager.md +++ b/.opencode/agent/meta/repo-manager.md @@ -2,7 +2,7 @@ # OpenCode Agent Configuration id: repo-manager name: OpenRepoManager -description: "Meta agent for managing OpenAgents repository development with lazy context loading, smart delegation, and automatic documentation" +description: "Meta agent for managing OpenAgents Control repository development with lazy context loading, smart delegation, and automatic documentation" category: meta type: meta version: 2.0.0 @@ -87,14 +87,14 @@ tags: - Meta agent for OpenAgents repository development and maintenance + Meta agent for OpenAgents Control repository development and maintenance Agents, evals, registry, context system, documentation Context-aware planning, task breakdown, subagent coordination Repository-specific standards enforcement with lazy context loading - Repository Manager - OpenAgents development specialist + Repository Manager - OpenAgents Control development specialist Coordinates repo development, delegates to specialists, maintains docs Agent creation, eval testing, registry management, context organization Approval-gated, context-first, quality-focused, lazy-loading diff --git a/.opencode/agent/subagents/code/build-agent.md b/.opencode/agent/subagents/code/build-agent.md index 2d56255..8b0fa66 100644 --- a/.opencode/agent/subagents/code/build-agent.md +++ b/.opencode/agent/subagents/code/build-agent.md @@ -12,6 +12,7 @@ tools: bash: true read: true grep: true + task: true permissions: bash: "tsc": "allow" @@ -26,6 +27,9 @@ permissions: "*": "deny" edit: "**/*": "deny" + task: + contextscout: "allow" + "*": "deny" # Tags tags: @@ -55,12 +59,31 @@ You are a build validation agent. Detect the project language and perform approp 1. Type check: `cargo check` 2. Build: `cargo build` +## Context Discovery + +Before running build checks, if you need context about build standards: + +1. **Call ContextScout** to discover build/validation guidelines: + ``` + task(subagent_type="ContextScout", description="Find build standards", prompt="Find build validation and type checking guidelines") + ``` + +2. **Load discovered files** using the `read` tool. + +3. **Apply build standards** (e.g., type checking requirements, build conventions). + +**When to call ContextScout:** +- When you need to verify expected build commands +- When you need type checking standards +- When project doesn't match standard configurations + ## Execution Steps 1. **Detect Language** - Check for `package.json`, `requirements.txt`, `go.mod`, or `Cargo.toml` -2. **Type Check** - Run appropriate type checker for the language -3. **Build Check** - Run appropriate build command -4. **Report** - Return errors if any occur, otherwise report success +2. **Context Discovery** (if needed, call ContextScout to find build standards). +3. **Type Check** - Run appropriate type checker for the language +4. **Build Check** - Run appropriate build command +5. **Report** - Return errors if any occur, otherwise report success **Rules:** - Adapt to the detected language diff --git a/.opencode/agent/subagents/code/coder-agent.md b/.opencode/agent/subagents/code/coder-agent.md index 9b75188..7130725 100644 --- a/.opencode/agent/subagents/code/coder-agent.md +++ b/.opencode/agent/subagents/code/coder-agent.md @@ -16,6 +16,7 @@ tools: glob: true bash: false patch: true + task: true permissions: bash: "*": "deny" @@ -25,6 +26,9 @@ permissions: "**/*.secret": "deny" "node_modules/**": "deny" ".git/**": "deny" + task: + contextscout: "allow" + "*": "deny" # Tags tags: @@ -49,15 +53,35 @@ You are a Coder Agent (@coder-agent). Your primary responsibility is to execute - Do not overcomplicate solutions; keep code modular and well-commented. - If a subtask is unclear, request clarification before proceeding. +## Context Discovery + +Before implementing, if you need additional context files beyond what's provided in the task JSON: + +1. **Call ContextScout** to discover relevant standards: + ``` + task(subagent_type="ContextScout", description="Find context for...", prompt="...") + ``` + +2. **Load discovered files** using the `read` tool. + +3. **Apply standards** to your implementation. + +**When to call ContextScout:** +- When task JSON doesn't specify all needed context files +- When you need to verify naming conventions or coding standards +- When you need security patterns or testing guidelines +- When you need documentation standards + ## Workflow 1. **Receive subtask plan** (with ordered list of subtasks). -2. **Iterate through each subtask in order:** - - Read the subtask file and requirements. - - Implement the solution in the appropriate file(s). - - Validate completion (e.g., run tests if specified). - - Mark as done. -3. **Repeat** until all subtasks are finished. +2. **Discover context** (if needed, call ContextScout to find relevant standards). +3. **Iterate through each subtask in order:** + - Read the subtask file and requirements. + - Implement the solution in the appropriate file(s). + - Validate completion (e.g., run tests if specified). + - Mark as done. +4. **Repeat** until all subtasks are finished. --- diff --git a/.opencode/agent/subagents/code/reviewer.md b/.opencode/agent/subagents/code/reviewer.md index 2babd01..7bcddd9 100644 --- a/.opencode/agent/subagents/code/reviewer.md +++ b/.opencode/agent/subagents/code/reviewer.md @@ -15,11 +15,15 @@ tools: bash: false edit: false write: false + task: true permissions: bash: "*": "deny" edit: "**/*": "deny" + task: + contextscout: "allow" + "*": "deny" # Tags tags: @@ -39,9 +43,28 @@ Responsibilities: - Load project-specific context for accurate pattern validation - First sentence should be Start with "Reviewing..., what would you devs do if I didn't check up on you?" -Workflow: +## Context Discovery -1. **ANALYZE** request and load relevant project context +Before reviewing, if you need context about code quality or security standards: + +1. **Call ContextScout** to discover review guidelines: + ``` + task(subagent_type="ContextScout", description="Find review standards", prompt="Find code review, security, and quality patterns") + ``` + +2. **Load discovered files** using the `read` tool. + +3. **Apply review standards** (code quality, security patterns, etc.). + +**When to call ContextScout:** +- When you need code quality standards +- When you need security patterns for vulnerability checks +- When you need documentation or naming conventions +- When context files aren't provided in the request + +## Workflow + +1. **ANALYZE** request and load relevant project context (or call ContextScout if needed). 2. Share a short review plan (files/concerns to inspect, including security aspects) and ask to proceed. 3. Provide concise review notes with suggested diffs (do not apply changes), including any security concerns. diff --git a/.opencode/agent/subagents/code/tester.md b/.opencode/agent/subagents/code/tester.md index 2fbce83..973a3f9 100644 --- a/.opencode/agent/subagents/code/tester.md +++ b/.opencode/agent/subagents/code/tester.md @@ -15,6 +15,7 @@ tools: edit: true write: true bash: true + task: true permissions: bash: "rm -rf *": "ask" @@ -23,6 +24,9 @@ permissions: "**/*.env*": "deny" "**/*.key": "deny" "**/*.secret": "deny" + task: + contextscout: "allow" + "*": "deny" # Tags tags: @@ -44,12 +48,30 @@ Responsibilities: - Ensure tests cover acceptance criteria, edge cases, and error handling. - Author and run bun tests for the code before handoff. -Workflow: +## Context Discovery + +Before writing tests, if you need context about testing standards: + +1. **Call ContextScout** to discover testing guidelines: + ``` + task(subagent_type="ContextScout", description="Find test standards", prompt="Find test coverage and TDD guidelines") + ``` + +2. **Load discovered files** using the `read` tool. + +3. **Apply testing standards** (e.g., test coverage requirements, TDD patterns). + +**When to call ContextScout:** +- When you need test coverage requirements +- When you need TDD or testing patterns +- When you need to verify test structure conventions + +## Workflow 1. Propose a test plan: - - The objective, state the behaviors to be tested. - - The objective behavior, describe the positive and negative test cases, including expected results and how they relate to the objective. - - Request approval before implementation. + - The objective, state the behaviors to be tested. + - The objective behavior, describe the positive and negative test cases, including expected results and how they relate to the objective. + - Request approval before implementation. 2. Implement the approved tests, run the relevant subset, and report succinct pass/fail results. Rules: diff --git a/.opencode/agent/subagents/core/contextscout.md b/.opencode/agent/subagents/core/contextscout.md index 4411382..ff50e63 100644 --- a/.opencode/agent/subagents/core/contextscout.md +++ b/.opencode/agent/subagents/core/contextscout.md @@ -79,7 +79,7 @@ You recommend relevant context files from `.opencode/context/` based on the user - `.opencode/context/core/workflows/code-review.md` - `.opencode/context/core/workflows/delegation.md` -**OpenAgents Repo:** +**OpenAgents Control Repo:** - `.opencode/context/openagents-repo/quick-start.md` - `.opencode/context/openagents-repo/core-concepts/agents.md` - `.opencode/context/openagents-repo/core-concepts/evals.md` diff --git a/.opencode/agent/subagents/core/documentation.md b/.opencode/agent/subagents/core/documentation.md index ce73c01..afd1af5 100644 --- a/.opencode/agent/subagents/core/documentation.md +++ b/.opencode/agent/subagents/core/documentation.md @@ -15,6 +15,7 @@ tools: edit: true write: true bash: false + task: true permissions: bash: "*": "deny" @@ -24,6 +25,9 @@ permissions: "**/*.env*": "deny" "**/*.key": "deny" "**/*.secret": "deny" + task: + contextscout: "allow" + "*": "deny" # Tags tags: @@ -39,9 +43,27 @@ Responsibilities: - Maintain consistency with naming conventions and architecture decisions - Generate concise, high-signal docs; prefer examples and short lists -Workflow: +## Context Discovery -1. Propose what documentation will be added/updated and ask for approval. +Before writing documentation, if you need context about documentation standards: + +1. **Call ContextScout** to discover documentation guidelines: + ``` + task(subagent_type="ContextScout", description="Find doc standards", prompt="Find documentation formatting and structure guidelines") + ``` + +2. **Load discovered files** using the `read` tool. + +3. **Apply documentation standards** (formatting, structure, tone). + +**When to call ContextScout:** +- When you need documentation formatting standards +- When you need project-specific doc conventions +- When you need to verify structure requirements + +## Workflow + +1. Propose what documentation will be added/updated (or call ContextScout if needed to find doc standards). 2. Apply edits and summarize changes. Constraints: diff --git a/.opencode/command/commit-openagents.md b/.opencode/command/commit-openagents.md index a3ea2fb..3b34dde 100644 --- a/.opencode/command/commit-openagents.md +++ b/.opencode/command/commit-openagents.md @@ -2,7 +2,7 @@ description: Smart commit command for opencode-agents repository with automatic validation and conventional commits --- -# Commit OpenAgents Command +# Commit OpenAgents Control Command You are an AI agent that helps create well-formatted git commits specifically for the **opencode-agents** repository. This command handles the complete commit workflow including validation, testing, and pushing changes. diff --git a/.opencode/command/validate-repo.md b/.opencode/command/validate-repo.md index 154913d..189e97f 100644 --- a/.opencode/command/validate-repo.md +++ b/.opencode/command/validate-repo.md @@ -1,6 +1,6 @@ # Validate Repository -Comprehensive validation command that checks the entire OpenAgents repository for consistency between CLI, documentation, registry, and components. +Comprehensive validation command that checks the entire OpenAgents Control repository for consistency between CLI, documentation, registry, and components. ## Usage @@ -60,7 +60,7 @@ The command generates a detailed report showing: ## Instructions -You are a validation specialist. Your task is to comprehensively validate the OpenAgents repository for consistency and correctness. +You are a validation specialist. Your task is to comprehensively validate the OpenAgents Control repository for consistency and correctness. ### Step 1: Validate Registry JSON @@ -182,7 +182,7 @@ Based on findings, suggest: ## Example Report Format ```markdown -# OpenAgents Repository Validation Report +# OpenAgents Control Repository Validation Report Generated: 2025-11-19 14:30:00 diff --git a/.opencode/context/core/context-system/examples/navigation-examples.md b/.opencode/context/core/context-system/examples/navigation-examples.md index 0172d27..37001fe 100644 --- a/.opencode/context/core/context-system/examples/navigation-examples.md +++ b/.opencode/context/core/context-system/examples/navigation-examples.md @@ -15,9 +15,9 @@ **Token count**: ~250 tokens ```markdown -# OpenAgents Repository Navigation +# OpenAgents Control Repository Navigation -**Purpose**: Navigate OpenAgents repository context +**Purpose**: Navigate OpenAgents Control repository context --- diff --git a/.opencode/context/core/context-system/guides/organizing-context.md b/.opencode/context/core/context-system/guides/organizing-context.md index 40e7c68..eba98cf 100644 --- a/.opencode/context/core/context-system/guides/organizing-context.md +++ b/.opencode/context/core/context-system/guides/organizing-context.md @@ -51,7 +51,7 @@ **YES** ā†’ Use **Pattern A (Function-Based)** Examples: -- `openagents-repo/` - OpenAgents repository work +- `openagents-repo/` - OpenAgents Control repository work - `myproject-repo/` - Your project's repository **NO** ā†’ Continue to Step 2 diff --git a/.opencode/context/core/navigation.md b/.opencode/context/core/navigation.md index 0a7865f..6633ccd 100644 --- a/.opencode/context/core/navigation.md +++ b/.opencode/context/core/navigation.md @@ -79,4 +79,4 @@ core/ ## Related Context - **Development** ā†’ `../development/navigation.md` -- **OpenAgents Repo** ā†’ `../openagents-repo/navigation.md` +- **OpenAgents Control Repo** ā†’ `../openagents-repo/navigation.md` diff --git a/.opencode/context/core/workflows/navigation.md b/.opencode/context/core/workflows/navigation.md index a89e670..e517b25 100644 --- a/.opencode/context/core/workflows/navigation.md +++ b/.opencode/context/core/workflows/navigation.md @@ -37,4 +37,4 @@ ## Related - **Standards** ā†’ `../standards/navigation.md` -- **OpenAgents Delegation** ā†’ `../../openagents-repo/guides/subagent-invocation.md` +- **OpenAgents Control Delegation** ā†’ `../../openagents-repo/guides/subagent-invocation.md` diff --git a/.opencode/context/navigation.md b/.opencode/context/navigation.md index 04a3352..e610244 100644 --- a/.opencode/context/navigation.md +++ b/.opencode/context/navigation.md @@ -9,7 +9,7 @@ ``` .opencode/context/ ā”œā”€ā”€ core/ # Universal standards & workflows -ā”œā”€ā”€ openagents-repo/ # OpenAgents repository work +ā”œā”€ā”€ openagents-repo/ # OpenAgents Control repository work ā”œā”€ā”€ development/ # Software development (all stacks) ā”œā”€ā”€ ui/ # Visual design & UX ā”œā”€ā”€ content-creation/ # Content creation (all formats) diff --git a/.opencode/context/openagents-repo/core-concepts/agents.md b/.opencode/context/openagents-repo/core-concepts/agents.md index b37af34..4256fc4 100644 --- a/.opencode/context/openagents-repo/core-concepts/agents.md +++ b/.opencode/context/openagents-repo/core-concepts/agents.md @@ -1,6 +1,6 @@ # Core Concept: Agents -**Purpose**: Understanding how agents work in OpenAgents +**Purpose**: Understanding how agents work in OpenAgents Control **Priority**: CRITICAL - Load this before working with agents --- @@ -160,14 +160,14 @@ Agents: ## Claude Code Interop (Optional) -OpenAgents can pair with Claude Code for local workflows and distribution: +OpenAgents Control can pair with Claude Code for local workflows and distribution: - **Subagents**: Project helpers in `.claude/agents/` - **Skills**: Auto-invoked guidance in `.claude/skills/` - **Hooks**: Shell commands on lifecycle events (use sparingly) - **Plugins**: Share agents/skills/hooks across projects -Use this when you want Claude Code to follow OpenAgents standards or to ship reusable helpers. +Use this when you want Claude Code to follow OpenAgents Control standards or to ship reusable helpers. --- diff --git a/.opencode/context/openagents-repo/core-concepts/registry.md b/.opencode/context/openagents-repo/core-concepts/registry.md index 60f1770..1aa3c51 100644 --- a/.opencode/context/openagents-repo/core-concepts/registry.md +++ b/.opencode/context/openagents-repo/core-concepts/registry.md @@ -7,7 +7,7 @@ ## What Is the Registry? -The registry is a centralized catalog (`registry.json`) that tracks all components in OpenAgents: +The registry is a centralized catalog (`registry.json`) that tracks all components in OpenAgents Control: - **Agents** - AI agent prompts - **Subagents** - Delegated specialists - **Commands** - Slash commands diff --git a/.opencode/context/openagents-repo/examples/context-bundle-example.md b/.opencode/context/openagents-repo/examples/context-bundle-example.md index 081fa55..c37bba6 100644 --- a/.opencode/context/openagents-repo/examples/context-bundle-example.md +++ b/.opencode/context/openagents-repo/examples/context-bundle-example.md @@ -7,7 +7,7 @@ Status: in_progress ## Task Overview -Create a new data analyst agent for the OpenAgents repository. This agent will specialize in data analysis tasks including data visualization, statistical analysis, and data transformation. +Create a new data analyst agent for the OpenAgents Control repository. This agent will specialize in data analysis tasks including data visualization, statistical analysis, and data transformation. ## User Request @@ -160,7 +160,7 @@ Create a new data analyst agent for the OpenAgents repository. This agent will s 5. Update progress tracking as you complete steps **Your Task**: -Create a complete data analyst agent for the OpenAgents repository following all established conventions and standards. +Create a complete data analyst agent for the OpenAgents Control repository following all established conventions and standards. **Approach**: 1. **Load Context**: Read all context files listed above to understand: diff --git a/.opencode/context/openagents-repo/guides/building-cli-compact.md b/.opencode/context/openagents-repo/guides/building-cli-compact.md index c061a6e..d651978 100644 --- a/.opencode/context/openagents-repo/guides/building-cli-compact.md +++ b/.opencode/context/openagents-repo/guides/building-cli-compact.md @@ -1,7 +1,7 @@ -# Building CLIs in OpenAgents: Compact Guide +# Building CLIs in OpenAgents Control: Compact Guide **Category**: guide -**Purpose**: Rapidly build, register, and deploy CLI tools for OpenAgents skills +**Purpose**: Rapidly build, register, and deploy CLI tools for OpenAgents Control skills **Framework**: FAB (Features, Advantages, Benefits) --- diff --git a/.opencode/context/openagents-repo/guides/profile-validation.md b/.opencode/context/openagents-repo/guides/profile-validation.md index a513cbc..e5c45b3 100644 --- a/.opencode/context/openagents-repo/guides/profile-validation.md +++ b/.opencode/context/openagents-repo/guides/profile-validation.md @@ -238,7 +238,7 @@ Save this as: `scripts/registry/validate-profile-coverage.sh` # Install to temp directory mkdir -p /tmp/test-install cd /tmp/test-install - REGISTRY_URL="file://$(pwd)/registry.json" bash <(curl -s https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh) developer + REGISTRY_URL="file://$(pwd)/registry.json" bash <(curl -s https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh) developer # Check if agent was installed ls .opencode/agent/category/your-agent.md diff --git a/.opencode/context/openagents-repo/navigation.md b/.opencode/context/openagents-repo/navigation.md index f047f8d..c46c399 100644 --- a/.opencode/context/openagents-repo/navigation.md +++ b/.opencode/context/openagents-repo/navigation.md @@ -1,6 +1,6 @@ -# OpenAgents Repository Context +# OpenAgents Control Repository Context -**Purpose**: Context files specific to the OpenAgents repository +**Purpose**: Context files specific to the OpenAgents Control repository **Last Updated**: 2026-01-13 diff --git a/.opencode/context/openagents-repo/quick-start.md b/.opencode/context/openagents-repo/quick-start.md index 4231a9b..9001bd9 100644 --- a/.opencode/context/openagents-repo/quick-start.md +++ b/.opencode/context/openagents-repo/quick-start.md @@ -1,4 +1,4 @@ -# OpenAgents Repository - Quick Start +# OpenAgents Control Repository - Quick Start **Purpose**: Get oriented in this repo in 2 minutes @@ -6,7 +6,7 @@ ## What Is This Repo? -OpenAgents is an AI agent framework with: +OpenAgents Control is an AI agent framework with: - **Category-based agents** (core, development, content, data, product, learning) - **Eval framework** for testing agent behavior - **Registry system** for component distribution diff --git a/COMPATIBILITY.md b/COMPATIBILITY.md index e75ea12..babc8e5 100644 --- a/COMPATIBILITY.md +++ b/COMPATIBILITY.md @@ -14,24 +14,24 @@ ### macOS / Linux ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s essential +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s essential ``` ### Windows (Git Bash) ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s essential +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s essential ``` ### Windows (PowerShell) ```powershell -Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh" -OutFile "install.sh" +Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh" -OutFile "install.sh" & "C:\Program Files\Git\bin\bash.exe" install.sh essential ``` ## Test Your System ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/scripts/tests/test-compatibility.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/scripts/tests/test-compatibility.sh | bash ``` ## Key Compatibility Features @@ -61,4 +61,4 @@ See [Platform Compatibility Guide](docs/getting-started/platform-compatibility.m 1. Run compatibility test: `bash scripts/tests/test-compatibility.sh` 2. Check bash version: `bash --version` -3. Report issues: [GitHub Issues](https://github.com/darrenhinde/OpenAgents/issues) +3. Report issues: [GitHub Issues](https://github.com/darrenhinde/OpenAgentsControl/issues) diff --git a/README.md b/README.md index 8435a66..3638213 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,13 @@
-# OpenAgents +# OpenAgents Control ### AI agent framework for plan-first development workflows with approval-based execution -[![GitHub stars](https://img.shields.io/github/stars/darrenhinde/OpenAgents?style=social)](https://github.com/darrenhinde/OpenAgents/stargazers) +[![GitHub stars](https://img.shields.io/github/stars/darrenhinde/OpenAgentsControl?style=social)](https://github.com/darrenhinde/OpenAgentsControl/stargazers) [![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/DarrenBuildsAI?style=social)](https://x.com/DarrenBuildsAI) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) -[![GitHub last commit](https://img.shields.io/github/last-commit/darrenhinde/OpenAgents)](https://github.com/darrenhinde/OpenAgents/commits/main) +[![GitHub last commit](https://img.shields.io/github/last-commit/darrenhinde/OpenAgentsControl)](https://github.com/darrenhinde/OpenAgentsControl/commits/main) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](docs/contributing/CONTRIBUTING.md) [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/darrenhinde) @@ -22,7 +22,7 @@ > **Note:** This repository has evolved since the demo video with continuous improvements to make it easier for others to use in their projects. The core concepts remain the same, but installation and component organization have been streamlined. -> šŸ“¹ **Following along with the video?** The simplified structure shown in the tutorial is available on the [`video-simple`](https://github.com/darrenhinde/OpenAgents/tree/video-simple) branch. +> šŸ“¹ **Following along with the video?** The simplified structure shown in the tutorial is available on the [`video-simple`](https://github.com/darrenhinde/OpenAgentsControl/tree/video-simple) branch. ## Why Use This? @@ -52,7 +52,7 @@ https://opencode.ai/docs# ```bash # Download the installer -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh -o install.sh +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh -o install.sh # Run interactively bash install.sh @@ -64,7 +64,7 @@ bash install.sh ```bash # Download the installer -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh -o install.sh +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh -o install.sh # Run interactively bash install.sh @@ -76,7 +76,7 @@ bash install.sh ```powershell # Download the script -Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh" -OutFile "install.sh" +Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh" -OutFile "install.sh" # Run with Git Bash & "C:\Program Files\Git\bin\bash.exe" install.sh @@ -107,19 +107,19 @@ The installer offers: ```bash # Essential - Minimal essentials (9 components) -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s essential +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s essential # Developer - Recommended for daily work (19 components) -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s developer +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer # Business - Business automation and content creation (15 components) -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s business +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s business # Full - Everything included (25 components) -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s full +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s full # Advanced - Full + System Builder (32 components) -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced ``` @@ -128,7 +128,7 @@ curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install ```powershell # Download script -Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh" -OutFile "install.sh" +Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh" -OutFile "install.sh" # Essential profile & "C:\Program Files\Git\bin\bash.exe" install.sh essential @@ -152,8 +152,8 @@ Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgents **Option C: Manual Install** ```bash # Clone this repository -git clone https://github.com/darrenhinde/OpenAgents.git -cd OpenAgents +git clone https://github.com/darrenhinde/OpenAgentsControl.git +cd OpenAgentsControl # Install to OpenCode directory (global) mkdir -p ~/.opencode @@ -316,7 +316,7 @@ The System Builder is an interactive tool that generates complete `.opencode` ar ### Quick Start ```bash # Install advanced profile (includes system builder) -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced # Run the interactive builder /build-context-system @@ -363,7 +363,7 @@ cd ~/.opencode/plugin npm install # Configure -cd ~/OpenAgents +cd ~/OpenAgentsControl cp env.example .env # Edit .env with TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID ``` @@ -384,7 +384,7 @@ cd ~/.opencode/tool npm install # Configure -cd ~/OpenAgents +cd ~/OpenAgentsControl cp env.example .env # Edit .env with GEMINI_API_KEY ``` @@ -393,14 +393,14 @@ cp env.example .env ### šŸ¤– Use with Claude Code (Beta) -> **āš ļø Beta Feature** - This integration allows Claude Code to understand and use OpenAgents standards. Works with Claude Code v2.1.6+ +> **āš ļø Beta Feature** - This integration allows Claude Code to understand and use OpenAgents Control standards. Works with Claude Code v2.1.6+ -OpenAgents includes a bridge that makes Claude Code automatically load context files and follow your coding patterns. +OpenAgents Control includes a bridge that makes Claude Code automatically load context files and follow your coding patterns.
For This Repository (Contributors) -If you're working **on** this repository and want Claude Code to understand OpenAgents: +If you're working **on** this repository and want Claude Code to understand OpenAgents Control: ```bash cd /path/to/opencode-agents @@ -410,23 +410,23 @@ claude Claude will automatically: - Load the `openagents-standards` Skill - Use `context-scout` to find relevant context files -- Apply OpenAgents standards to any task +- Apply OpenAgents Control standards to any task **If it doesn't auto-trigger**, restart Claude Code and start your request with: ``` -[Use OpenAgents standards] +[Use OpenAgents Control standards] ```
-For Your Own OpenAgents Projects +For Your Own OpenAgents Control Projects -If you've set up OpenAgents in your own project and want Claude Code support: +If you've set up OpenAgents Control in your own project and want Claude Code support: ```bash # One-line installer (recommended) -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/integrations/claude-code/install-claude.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/integrations/claude-code/install-claude.sh | bash # Use with Claude Code claude --plugin-dir ~/.claude/plugins/openagents-bridge @@ -449,7 +449,7 @@ cd /path/to/opencode-agents/integrations/claude-code - The installer automatically converts your `.opencode/` files to Claude format - Converts agents, subagents, and creates context-scout skill - Claude automatically discovers and follows your patterns -- No duplication - works with your existing OpenAgents setup +- No duplication - works with your existing OpenAgents Control setup
@@ -460,7 +460,7 @@ cd /path/to/opencode-agents/integrations/claude-code |---------|-------------| | `claude` | Start interactive session | | `claude "request"` | One-shot request | -| `claude --plugin-dir ~/.claude/plugins/openagents-bridge` | Load with OpenAgents plugin | +| `claude --plugin-dir ~/.claude/plugins/openagents-bridge` | Load with OpenAgents Control plugin | | `claude --print-plugins` | Show loaded plugins | | `claude --debug` | Debug mode (shows plugin loading) | @@ -511,7 +511,7 @@ mkdir -p ~/.opencode/agent/core # Download specific agent curl -o ~/.opencode/agent/core/opencoder.md \ - https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/.opencode/agent/core/opencoder.md + https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/.opencode/agent/core/opencoder.md ``` --- @@ -574,7 +574,7 @@ Keep your components up to date: ./update.sh # Or re-run the installer -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash ``` --- diff --git a/ROADMAP.md b/ROADMAP.md index 57da9bd..2e8b00a 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -1,8 +1,8 @@ -# OpenAgents Roadmap +# OpenAgents Control Roadmap -> **Interactive Board:** [GitHub Project - OpenAgents Roadmap & Tasks](https://github.com/users/darrenhinde/projects/2) +> **Interactive Board:** [GitHub Project - OpenAgents Control Roadmap & Tasks](https://github.com/users/darrenhinde/projects/2) -This roadmap tracks the evolution of OpenAgents - an AI agent framework for plan-first development workflows with approval-based execution. +This roadmap tracks the evolution of OpenAgents Control - an AI agent framework for plan-first development workflows with approval-based execution. --- @@ -52,7 +52,7 @@ Visit the [GitHub Project](https://github.com/users/darrenhinde/projects/2) to s Create an issue with the `idea` label: ```bash gh issue create \ - --repo darrenhinde/OpenAgents \ + --repo darrenhinde/OpenAgentsControl \ --title "Your idea title" \ --body "Description of your idea..." \ --label "idea" @@ -61,10 +61,10 @@ gh issue create \ ### Track Progress ```bash # List all ideas -gh issue list --repo darrenhinde/OpenAgents --label idea +gh issue list --repo darrenhinde/OpenAgentsControl --label idea # View specific issue -gh issue view 123 --repo darrenhinde/OpenAgents +gh issue view 123 --repo darrenhinde/OpenAgentsControl ``` --- diff --git a/dev/docs/context-reference-convention.md b/dev/docs/context-reference-convention.md index c63d9b4..245a8d4 100644 --- a/dev/docs/context-reference-convention.md +++ b/dev/docs/context-reference-convention.md @@ -2,7 +2,7 @@ ## Overview -All context file references in OpenAgents **MUST** use the standardized format: +All context file references in OpenAgents Control **MUST** use the standardized format: ```markdown @.opencode/context/path/to/file.md @@ -37,7 +37,7 @@ This convention is **required** for the installation system to work correctly ac ### Problem: Local vs Global Installations -Users can install OpenAgents in two ways: +Users can install OpenAgents Control in two ways: **Local Install:** ```bash diff --git a/docs/README.md b/docs/README.md index 47809fa..73e5c04 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,6 +1,6 @@ -# OpenAgents Documentation +# OpenAgents Control Documentation -Welcome to the OpenAgents documentation! This directory contains all documentation organized by topic. +Welcome to the OpenAgents Control documentation! This directory contains all documentation organized by topic. ## šŸ“š Documentation Index @@ -36,7 +36,7 @@ Welcome to the OpenAgents documentation! This directory contains all documentati ### For Contributors - Read the [Contributing Guide](contributing/CONTRIBUTING.md) - Review the [Code of Conduct](contributing/CODE_OF_CONDUCT.md) -- Check out [good first issues](https://github.com/darrenhinde/OpenAgents/labels/good%20first%20issue) +- Check out [good first issues](https://github.com/darrenhinde/OpenAgentsControl/labels/good%20first%20issue) ### For Advanced Users - Study the [Agent System Blueprint](features/agent-system-blueprint.md) @@ -67,7 +67,7 @@ docs/ ### I want to... -**...install OpenAgents** +**...install OpenAgents Control** ā†’ [Installation Guide](getting-started/installation.md) **...understand collision handling** @@ -83,20 +83,20 @@ docs/ ā†’ [Contributing Guide](contributing/CONTRIBUTING.md) **...report a bug or request a feature** -ā†’ [GitHub Issues](https://github.com/darrenhinde/OpenAgents/issues) +ā†’ [GitHub Issues](https://github.com/darrenhinde/OpenAgentsControl/issues) ## šŸ’” Additional Resources - **Main README**: [../README.md](../README.md) -- **GitHub Repository**: https://github.com/darrenhinde/OpenAgents +- **GitHub Repository**: https://github.com/darrenhinde/OpenAgentsControl - **OpenCode CLI Docs**: https://opencode.ai/docs - **Component Registry**: [../registry.json](../registry.json) ## šŸ¤ Community -- **Issues**: [Report bugs or request features](https://github.com/darrenhinde/OpenAgents/issues) -- **Discussions**: [Ask questions and share ideas](https://github.com/darrenhinde/OpenAgents/discussions) -- **Pull Requests**: [Contribute code](https://github.com/darrenhinde/OpenAgents/pulls) +- **Issues**: [Report bugs or request features](https://github.com/darrenhinde/OpenAgentsControl/issues) +- **Discussions**: [Ask questions and share ideas](https://github.com/darrenhinde/OpenAgentsControl/discussions) +- **Pull Requests**: [Contribute code](https://github.com/darrenhinde/OpenAgentsControl/pulls) ## šŸ“ License @@ -104,4 +104,4 @@ This project is licensed under the MIT License. See [LICENSE](../LICENSE) for de --- -**Need help?** Check the [Contributing Guide](contributing/CONTRIBUTING.md) or open an [issue](https://github.com/darrenhinde/OpenAgents/issues). +**Need help?** Check the [Contributing Guide](contributing/CONTRIBUTING.md) or open an [issue](https://github.com/darrenhinde/OpenAgentsControl/issues). diff --git a/docs/agents/repo-manager.md b/docs/agents/repo-manager.md index 7c4b5c9..2d9be68 100644 --- a/docs/agents/repo-manager.md +++ b/docs/agents/repo-manager.md @@ -10,7 +10,7 @@ ## Overview -The Repository Manager is a meta agent specifically designed for managing development work on the OpenAgents repository itself. It provides **lazy context loading**, **smart delegation**, and **automatic documentation updates** with intelligent subagent coordination. +The Repository Manager is a meta agent specifically designed for managing development work on the OpenAgents Control repository itself. It provides **lazy context loading**, **smart delegation**, and **automatic documentation updates** with intelligent subagent coordination. ### What's New in v2.0 @@ -24,7 +24,7 @@ The Repository Manager is a meta agent specifically designed for managing develo ## Purpose -While `openagent` is a universal agent for any project, `repo-manager` is specialized for OpenAgents repository development. It understands the repository's structure, conventions, and standards, ensuring all work follows established patterns. +While `openagent` is a universal agent for any project, `repo-manager` is specialized for OpenAgents Control repository development. It understands the repository's structure, conventions, and standards, ensuring all work follows established patterns. --- @@ -72,7 +72,7 @@ Use `repo-manager` for: - āœ… Updating the registry - āœ… Managing context files - āœ… Updating documentation -- āœ… Any OpenAgents repository development +- āœ… Any OpenAgents Control repository development Don't use `repo-manager` for: - āŒ Working on user projects (use `openagent` instead) diff --git a/docs/contributing/ADDING_EVALUATOR.md b/docs/contributing/ADDING_EVALUATOR.md index b4bfb28..4df9a94 100644 --- a/docs/contributing/ADDING_EVALUATOR.md +++ b/docs/contributing/ADDING_EVALUATOR.md @@ -1,4 +1,4 @@ -# Guide: Adding a New Evaluator to the OpenAgents Framework +# Guide: Adding a New Evaluator to the OpenAgents Control Framework This guide explains how to create, register, and test a new *Evaluator* inside the evaluation framework located at `evals/framework`. It focuses on validating agent behaviors without coupling to internal implementation details. diff --git a/docs/contributing/CONTRIBUTING.md b/docs/contributing/CONTRIBUTING.md index 20e6e90..be6b3f3 100644 --- a/docs/contributing/CONTRIBUTING.md +++ b/docs/contributing/CONTRIBUTING.md @@ -1,4 +1,4 @@ -# Contributing to OpenAgents +# Contributing to OpenAgents Control Thank you for your interest in contributing! This guide will help you add new components to the registry and understand the repository structure. diff --git a/docs/contributing/DEVELOPMENT.md b/docs/contributing/DEVELOPMENT.md index ccc57cb..3771ad7 100644 --- a/docs/contributing/DEVELOPMENT.md +++ b/docs/contributing/DEVELOPMENT.md @@ -1,8 +1,8 @@ # Development Guide -**Complete guide for developing on the OpenAgents repository** +**Complete guide for developing on the OpenAgents Control repository** -This guide covers everything you need to know to develop agents, commands, tools, and contribute to the OpenAgents ecosystem. +This guide covers everything you need to know to develop agents, commands, tools, and contribute to the OpenAgents Control ecosystem. ## Table of Contents @@ -30,8 +30,8 @@ This guide covers everything you need to know to develop agents, commands, tools ```bash # Clone the repository -git clone https://github.com/darrenhinde/OpenAgents.git -cd OpenAgents +git clone https://github.com/darrenhinde/OpenAgentsControl.git +cd OpenAgentsControl # Install dependencies for testing framework cd evals/framework @@ -74,7 +74,7 @@ opencode-agents/ ā”‚ ā”‚ ā”œā”€ā”€ system-builder/ # System building subagents ā”‚ ā”‚ ā””ā”€ā”€ utils/ # Utility subagents ā”‚ ā”œā”€ā”€ command/ # Slash commands -ā”‚ ā”‚ ā”œā”€ā”€ openagents/ # OpenAgents-specific commands +ā”‚ ā”‚ ā”œā”€ā”€ openagents/ # OpenAgents Control-specific commands ā”‚ ā”‚ ā”‚ ā””ā”€ā”€ new-agents/ # Agent creation system ā­ ā”‚ ā”‚ ā””ā”€ā”€ prompt-engineering/ # Prompt optimization commands ā”‚ ā”œā”€ā”€ context/ # Context files diff --git a/docs/features/abilities-system/PLAN.md b/docs/features/abilities-system/PLAN.md index cbfec71..1535f50 100644 --- a/docs/features/abilities-system/PLAN.md +++ b/docs/features/abilities-system/PLAN.md @@ -1,7 +1,7 @@ # Abilities System - Implementation Plan > **Status:** Planning Complete - Ready for Implementation -> **Issue:** [#33](https://github.com/darrenhinde/OpenAgents/issues/33) +> **Issue:** [#33](https://github.com/darrenhinde/OpenAgentsControl/issues/33) > **Date:** December 31, 2025 --- @@ -37,7 +37,7 @@ Abilities solve the fundamental problem with Skills: **LLMs ignore them**. With | Hook enforcement | AI **cannot** skip steps | | Script steps | Deterministic execution | | Validation rules | Guaranteed completion | -| Multi-agent support | Coordinate any OpenAgents agent | +| Multi-agent support | Coordinate any OpenAgents Control agent | | Approval gates | Human-in-the-loop where needed | --- @@ -258,7 +258,7 @@ settings: ```yaml - id: review type: agent - agent: reviewer # Agent name (from OpenAgents) + agent: reviewer # Agent name (from OpenAgents Control) prompt: "Review this code..." # Task for agent context: # Additional context (optional) - ./src/ @@ -733,7 +733,7 @@ steps: | Abilities load correctly | All YAML files parse without error | | Validation catches errors | Invalid YAMLs rejected with clear messages | | Scripts execute | Exit codes captured, validation works | -| Agents integrate | Can call any OpenAgents agent | +| Agents integrate | Can call any OpenAgents Control agent | | Enforcement works | Cannot skip steps when strict | | Approvals work | Human gate blocks until approved | | Context passes | Prior step outputs available to next | @@ -742,7 +742,7 @@ steps: ## References -- [Issue #33](https://github.com/darrenhinde/OpenAgents/issues/33) - Original proposal +- [Issue #33](https://github.com/darrenhinde/OpenAgentsControl/issues/33) - Original proposal - [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) - Plugin patterns - [OpenCode Skills](https://opencode.ai/docs/skills/) - Current skill system - [Scott Spence - Making Skills Reliable](https://scottspence.com/posts/how-to-make-claude-code-skills-activate-reliably) diff --git a/docs/features/system-builder/README.md b/docs/features/system-builder/README.md index f10e8e3..d9e3f5b 100644 --- a/docs/features/system-builder/README.md +++ b/docs/features/system-builder/README.md @@ -9,7 +9,7 @@ The system builder is included in the **Advanced** profile: ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced ``` **What you get:** @@ -25,7 +25,7 @@ Already have `core`, `developer`, or `full` profile? Add system builder: ```bash # Run advanced profile -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced # When prompted about collisions: # Choose: 1) Skip existing diff --git a/docs/features/system-builder/quick-start.md b/docs/features/system-builder/quick-start.md index 402f4a5..5bb20f9 100644 --- a/docs/features/system-builder/quick-start.md +++ b/docs/features/system-builder/quick-start.md @@ -15,7 +15,7 @@ An **interactive AI system generator** that creates complete `.opencode` archite ```bash # Install Advanced profile (includes system builder) -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced ``` **What you get:** @@ -33,7 +33,7 @@ Already have `developer` or `full` profile? Add system builder: ```bash # Run advanced profile -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced # When prompted about collisions: # Choose: 1) Skip existing @@ -178,7 +178,7 @@ When you install **advanced** profile, you get: **Installation:** ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced ``` **Usage:** diff --git a/docs/getting-started/context-aware-system/QUICK_START_SYSTEM_BUILDER.md b/docs/getting-started/context-aware-system/QUICK_START_SYSTEM_BUILDER.md index e5e6895..132ae81 100644 --- a/docs/getting-started/context-aware-system/QUICK_START_SYSTEM_BUILDER.md +++ b/docs/getting-started/context-aware-system/QUICK_START_SYSTEM_BUILDER.md @@ -15,7 +15,7 @@ An **interactive AI system generator** that creates complete `.opencode` archite ```bash # Install Advanced profile (includes system builder) -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced ``` **What you get:** @@ -33,7 +33,7 @@ Already have `developer` or `full` profile? Add system builder: ```bash # Run advanced profile -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced # When prompted about collisions: # Choose: 1) Skip existing @@ -360,7 +360,7 @@ When you install **advanced** profile, you get: **Installation:** ```bash -curl -fsSL .../install.sh | bash -s advanced +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced ``` **Usage:** diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index d506174..61949be 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.md @@ -1,6 +1,6 @@ -# OpenAgents Installation Guide +# OpenAgents Control Installation Guide -Complete guide to installing OpenAgents components using the automated installer script. +Complete guide to installing OpenAgents Control components using the automated installer script. --- @@ -10,10 +10,10 @@ Complete guide to installing OpenAgents components using the automated installer ```bash # Interactive mode - choose components -bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh) +bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh) # Quick install with profile -bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh) developer +bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh) developer ``` Installs to `.opencode/` in your current directory. @@ -27,7 +27,7 @@ Installs to `.opencode/` in your current directory. Run the installer without arguments to get an interactive experience: ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash ``` **Interactive Flow:** @@ -55,26 +55,26 @@ Install a pre-configured set of components: ```bash # Essential - Minimal setup with core agents -bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh) essential +bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh) essential # Developer - Code-focused development tools -bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh) developer +bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh) developer # Business - Content and business-focused tools -bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh) business +bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh) business # Full - Everything except system-builder -bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh) full +bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh) full # Advanced - Complete system with all components -bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh) advanced +bash <(curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh) advanced ``` ### 3. Download & Run (For Offline or Repeated Use) ```bash # Download the installer -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh -o install.sh +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh -o install.sh # Make it executable chmod +x install.sh @@ -239,7 +239,7 @@ Installation directory is determined by (highest to lowest priority): ```bash # Standard installation -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s developer +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer # Global installation ./install.sh developer --install-dir ~/.config/opencode @@ -252,7 +252,7 @@ sudo ./install.sh developer --install-dir /opt/opencode ```bash # Standard installation -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s developer +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer # Global installation (XDG standard) ./install.sh developer --install-dir ~/.config/opencode @@ -265,7 +265,7 @@ curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install ```bash # Standard installation -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s developer +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer # Global installation ./install.sh developer --install-dir ~/.config/opencode @@ -278,7 +278,7 @@ curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install ```bash # Same as Linux -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s developer +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer # Global installation ./install.sh developer --install-dir ~/.config/opencode @@ -580,7 +580,7 @@ export OPENCODE_BRANCH=main ### Example 1: First-Time Local Installation ```bash # Download and run installer -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s developer +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer # Result: Installs to .opencode/ in current directory ``` @@ -656,14 +656,14 @@ After installation: - **View installer help:** `./install.sh --help` - **List components:** `./install.sh --list` -- **Documentation:** [GitHub Repository](https://github.com/darrenhinde/OpenAgents) -- **Report issues:** [GitHub Issues](https://github.com/darrenhinde/OpenAgents/issues) +- **Documentation:** [GitHub Repository](https://github.com/darrenhinde/OpenAgentsControl) +- **Report issues:** [GitHub Issues](https://github.com/darrenhinde/OpenAgentsControl/issues) --- ## Summary -The OpenAgents installer provides: +The OpenAgents Control installer provides: āœ… **Flexible installation locations** - Local, global, or custom āœ… **Multiple installation methods** - Interactive, profile-based, or custom @@ -671,4 +671,4 @@ The OpenAgents installer provides: āœ… **Safe updates** - Collision detection and backup options āœ… **Easy to use** - Simple commands, clear prompts -Choose the installation method that fits your needs and get started with OpenAgents! +Choose the installation method that fits your needs and get started with OpenAgents Control! diff --git a/docs/getting-started/platform-compatibility.md b/docs/getting-started/platform-compatibility.md index e1345b3..4136a1c 100644 --- a/docs/getting-started/platform-compatibility.md +++ b/docs/getting-started/platform-compatibility.md @@ -1,6 +1,6 @@ # Platform Compatibility Guide -The OpenAgents installer is designed to work across multiple platforms and bash versions. +The OpenAgents Control installer is designed to work across multiple platforms and bash versions. ## Supported Platforms @@ -11,10 +11,10 @@ The OpenAgents installer is designed to work across multiple platforms and bash ```bash # Standard installation -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash # Profile-based installation -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s core +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s core ``` **Dependencies:** @@ -32,10 +32,10 @@ brew install curl jq ```bash # Standard installation -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash # Profile-based installation -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s developer +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer ``` **Dependencies:** @@ -90,10 +90,10 @@ apk add curl jq bash **Run Installer:** ```bash # Standard installation -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash # Profile-based installation -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s full +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s full ``` #### Option 2: WSL (Windows Subsystem for Linux) @@ -110,7 +110,7 @@ wsl --install **Run Installer:** ```bash # In WSL terminal -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash ``` **Dependencies:** @@ -125,7 +125,7 @@ sudo apt-get install curl jq ```powershell # Download the script -Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh" -OutFile "install.sh" +Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh" -OutFile "install.sh" # Run with Git Bash & "C:\Program Files\Git\bin\bash.exe" install.sh core @@ -200,15 +200,15 @@ Run the compatibility test to verify your system: ```bash # Download and run the test -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/scripts/tests/test-compatibility.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/scripts/tests/test-compatibility.sh | bash ``` Or manually: ```bash # Clone the repo -git clone https://github.com/darrenhinde/OpenAgents.git -cd OpenAgents +git clone https://github.com/darrenhinde/OpenAgentsControl.git +cd OpenAgentsControl # Run the test bash scripts/tests/test-compatibility.sh @@ -232,7 +232,7 @@ The test checks: **Status:** āœ… **FIXED in v1.1.0** **Solution:** Update to the latest installer: ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh > install.sh +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh > install.sh bash install.sh developer ``` @@ -246,7 +246,7 @@ bash install.sh developer **Cause:** Using bash version < 4.0 **Solution:** This should be fixed in the latest version. Update the installer: ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh > install.sh +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh > install.sh bash install.sh developer ``` @@ -303,7 +303,7 @@ sudo bash install.sh core **Solution:** Use Git Bash or WSL: ```powershell # Download first -Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh" -OutFile "install.sh" +Invoke-WebRequest -Uri "https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh" -OutFile "install.sh" # Run with Git Bash & "C:\Program Files\Git\bin\bash.exe" install.sh @@ -331,8 +331,8 @@ If you can't use the installer: ```bash # 1. Clone or download the repository -git clone https://github.com/darrenhinde/OpenAgents.git -cd OpenAgents +git clone https://github.com/darrenhinde/OpenAgentsControl.git +cd OpenAgentsControl # 2. Copy to OpenCode directory mkdir -p ~/.opencode @@ -355,7 +355,7 @@ If you encounter issues: 1. **Run the compatibility test:** ```bash - curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/scripts/tests/test-compatibility.sh | bash + curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/scripts/tests/test-compatibility.sh | bash ``` 2. **Check your bash version:** @@ -370,7 +370,7 @@ If you encounter issues: ``` 4. **Report issues:** - - [GitHub Issues](https://github.com/darrenhinde/OpenAgents/issues) + - [GitHub Issues](https://github.com/darrenhinde/OpenAgentsControl/issues) - Include: Platform, Bash version, Error message --- diff --git a/docs/github/GITHUB_SETTINGS.md b/docs/github/GITHUB_SETTINGS.md index c657c62..7429e8e 100644 --- a/docs/github/GITHUB_SETTINGS.md +++ b/docs/github/GITHUB_SETTINGS.md @@ -11,7 +11,7 @@ After merging this PR, update these GitHub repository settings: AI agent framework for plan-first development workflows with approval-based execution. Multi-language support (TypeScript, Python, Go, Rust) with automatic testing, code review, and validation. ``` -**Website:** `https://github.com/darrenhinde/OpenAgents` +**Website:** `https://github.com/darrenhinde/OpenAgentsControl` ## 2. Topics (Add All 16) diff --git a/evals/agents/meta/repo-manager/README.md b/evals/agents/meta/repo-manager/README.md index 12de22d..07e9e1d 100644 --- a/evals/agents/meta/repo-manager/README.md +++ b/evals/agents/meta/repo-manager/README.md @@ -9,7 +9,7 @@ ## Overview -Eval tests for the Repository Manager meta agent. This agent orchestrates OpenAgents repository development with context-aware planning, task breakdown, and automatic documentation. +Eval tests for the Repository Manager meta agent. This agent orchestrates OpenAgents Control repository development with context-aware planning, task breakdown, and automatic documentation. ## Test Suites diff --git a/install.sh b/install.sh index 572d583..98479d3 100755 --- a/install.sh +++ b/install.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash ############################################################################# -# OpenAgents Installer +# OpenAgents Control Installer # Interactive installer for OpenCode agents, commands, tools, and plugins # # Compatible with: @@ -44,9 +44,9 @@ else fi # Configuration -REPO_URL="https://github.com/darrenhinde/OpenAgents" +REPO_URL="https://github.com/darrenhinde/OpenAgentsControl" BRANCH="${OPENCODE_BRANCH:-main}" # Allow override via environment variable -RAW_URL="https://raw.githubusercontent.com/darrenhinde/OpenAgents/${BRANCH}" +RAW_URL="https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/${BRANCH}" # Registry URL - supports local fallback for development # Priority: 1) REGISTRY_URL env var, 2) Local registry.json, 3) Remote GitHub @@ -90,7 +90,7 @@ print_header() { echo -e "${CYAN}${BOLD}" echo "ā•”ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•—" echo "ā•‘ ā•‘" - echo "ā•‘ OpenAgents Installer v1.0.0 ā•‘" + echo "ā•‘ OpenAgents Control Installer v1.0.0 ā•‘" echo "ā•‘ ā•‘" echo "ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•" echo -e "${NC}" @@ -477,7 +477,7 @@ check_interactive_mode() { echo "For interactive mode, download the script first:" echo "" echo -e "${CYAN}# Download the script${NC}" - echo "curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh -o install.sh" + echo "curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh -o install.sh" echo "" echo -e "${CYAN}# Run interactively${NC}" echo "bash install.sh" @@ -485,7 +485,7 @@ check_interactive_mode() { echo "Or use a profile directly:" echo "" echo -e "${CYAN}# Quick install with profile${NC}" - echo "curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s essential" + echo "curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s essential" echo "" echo "Available profiles: essential, developer, business, full, advanced" echo "" @@ -1369,7 +1369,7 @@ main() { echo " $0 developer" echo "" echo " ${CYAN}# Install from URL (non-interactive)${NC}" - echo " curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash -s developer" + echo " curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer" echo "" echo -e "${BOLD}Platform Support:${NC}" echo " āœ“ Linux (bash 3.2+)" diff --git a/integrations/claude-code/README.md b/integrations/claude-code/README.md index 4a98f47..37ffa09 100644 --- a/integrations/claude-code/README.md +++ b/integrations/claude-code/README.md @@ -1,31 +1,23 @@ -# OpenAgents ā†” Claude Code Integration +# OpenAgents Control ā†” Claude Code Integration -A bridge that allows Claude Code to use OpenAgents standards and context files. +A bridge that allows Claude Code to use OpenAgents Control standards and context files. ## Overview -This integration provides two-way compatibility between OpenAgents and Claude Code: +This integration provides two-way compatibility between OpenAgents Control and Claude Code: -1. **Auto-Convert**: Convert OpenAgents to Claude Code format for distribution +1. **Auto-Convert**: Convert OpenAgents Control to Claude Code format for distribution 2. **Local Adapter**: Immediate context-aware behavior when using Claude in this repo ## Directory Structure ``` integrations/claude-code/ -ā”œā”€ā”€ converter/ # Scripts to convert OpenAgents ā†’ Claude format -ā”‚ ā””ā”€ā”€ src/ -ā”‚ ā””ā”€ā”€ convert-agents.js +ā”œā”€ā”€ converter/ # Scripts to convert OpenAgents Control ā†’ Claude format ā”œā”€ā”€ generated/ # Output of conversion (gitignored) -ā”‚ ā”œā”€ā”€ agents/ -ā”‚ ā””ā”€ā”€ skills/ ā”œā”€ā”€ plugin/ # Final plugin files for distribution -ā”‚ ā”œā”€ā”€ agents/ -ā”‚ ā”œā”€ā”€ skills/ -ā”‚ ā””ā”€ā”€ .claude-plugin/ -ā”‚ ā””ā”€ā”€ plugin.json ā”œā”€ā”€ bootstrap-install.sh # One-line installer (downloads bundle) -ā””ā”€ā”€ install.sh # Install script for distribution +ā””ā”€ā”€ install-claude.sh # Install script for distribution ``` ## Quick Start @@ -35,14 +27,14 @@ integrations/claude-code/ Just run Claude in this repository: ```bash -cd /path/to/opencode-agents +cd OpenAgentsControl claude ``` Claude will automatically: -- Load the `openagents-standards` Skill +- Load the `openagents-control-standards` Skill - Use `context-scout` to find relevant context in `.opencode/context/` -- Apply OpenAgents standards to any task +- Apply OpenAgents Control standards to any task
āš ļø Claude CLI Workaround @@ -52,21 +44,22 @@ If Claude doesn't auto-load the local adapter when run in this repository: 1. **Restart Claude Code** after any changes to `.claude/` 2. **Explicitly reference the context** in your request: ``` - "Load context from .claude/skills/openagents-standards/SKILL.md and .claude/agents/context-scout.md, then help me create a new agent" + "Load context from .claude/skills/openagents-control-standards/SKILL.md and .claude/agents/context-scout.md, then help me create a new agent" ``` 3. **Manual trigger** - if the Skill doesn't auto-trigger, start your request with: ``` - [Use OpenAgents standards] + [Use OpenAgents Control standards] ``` This will activate the context loading workflow. **Known Issue**: Skills auto-trigger based on Claude's heuristic. If it doesn't trigger: - The `context-scout` subagent will still be available - You can call it manually: `task(subagent_type="context-scout", ...)` -- Claude will still follow OpenAgents patterns if you reference `.opencode/context/` files in your prompt +- Claude will still follow OpenAgents Control patterns if you reference `.opencode/context/` files in your prompt
+ ### Install Claude CLI (if needed) **macOS**: @@ -89,7 +82,7 @@ claude --version ### One-Line Install (Recommended) ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/integrations/claude-code/bootstrap-install.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/integrations/claude-code/bootstrap-install.sh | bash ``` **Prereqs**: `git`, `bash` @@ -114,22 +107,22 @@ This generates Claude-ready files in `integrations/claude-code/generated/`. ```bash cd integrations/claude-code -./install.sh +./install-claude.sh ``` -This copies the plugin to `~/.claude/plugins/openagents-bridge/`. +This copies the plugin to `~/.claude/plugins/openagents-control-bridge/`. ### Step 3: Use with Claude Code **With plugin (recommended for distributed use)**: ```bash -claude --plugin-dir ~/.claude/plugins/openagents-bridge +claude --plugin-dir ~/.claude/plugins/openagents-control-bridge ``` **Without plugin (manual mode)**: ```bash # Set environment variable to load context files -export OPENAGENTS_CONTEXT_PATH=.opencode/context +export OPENAGENTS_CONTROL_CONTEXT_PATH=.opencode/context # Run Claude with context loaded from your prompt claude @@ -149,15 +142,15 @@ claude ### Context Discovery -1. **Skill Triggers**: The `openagents-standards` Skill automatically activates when you ask Claude to do anything. +1. **Skill Triggers**: The `openagents-control-standards` Skill automatically activates when you ask Claude to do anything. 2. **Subagent Call**: Claude calls `context-scout` to find relevant files in `.opencode/context/`. -3. **Standards Loading**: Claude reads the discovered files and applies OpenAgents standards. +3. **Standards Loading**: Claude reads the discovered files and applies OpenAgents Control standards. ### Agent Conversion -The converter maps OpenAgents frontmatter to Claude format: +The converter maps OpenAgents Control frontmatter to Claude format: -| OpenAgents Field | Claude Field | +| OpenAgents Control Field | Claude Field | |------------------|--------------| | `id` | `name` | | `description` | `description` | @@ -181,7 +174,7 @@ Add to `.opencode/agent/{category}/{agent}.md`. The local adapter in `.claude/` - `.claude/` - Local adapter (committed) - `integrations/claude-code/converter/src/convert-agents.js` - Converter script (committed) -- `integrations/claude-code/install.sh` - Install script (committed) +- `integrations/claude-code/install-claude.sh` - Install script (committed) ## Files to GitIgnore @@ -199,7 +192,7 @@ Add to `.opencode/agent/{category}/{agent}.md`. The local adapter in `.claude/` |---------|-------------| | `claude` | Start interactive session | | `claude "request"` | One-shot request | -| `claude --plugin-dir ~/.claude/plugins/openagents-bridge` | Load with plugin | +| `claude --plugin-dir ~/.claude/plugins/openagents-control-bridge` | Load with plugin | | `claude --print-plugins` | Show loaded plugins | | `claude --debug` | Debug mode | | `claude --version` | Show version | diff --git a/integrations/claude-code/converter/src/convert-agents.js b/integrations/claude-code/converter/src/convert-agents.js index 6b7c496..7ace114 100644 --- a/integrations/claude-code/converter/src/convert-agents.js +++ b/integrations/claude-code/converter/src/convert-agents.js @@ -2,7 +2,7 @@ /** * convert-agents.js - * Converts OpenAgents to Claude Code format + * Converts OpenAgents Control to Claude Code format * * Usage: node convert-agents.js [--watch] */ @@ -22,7 +22,7 @@ const CLAUDE_SKILLS_DIR = path.join(OUTPUT_DIR, 'skills'); // Claude frontmatter fields (subset of OpenCode) const CLAUDE_FIELDS = ['name', 'description', 'tools', 'model', 'permissionMode', 'skills', 'hooks']; -console.log('šŸš€ OpenAgents ā†’ Claude Code Converter'); +console.log('šŸš€ OpenAgents Control ā†’ Claude Code Converter'); console.log(` Source: ${SOURCE_DIR}`); console.log(` Output: ${OUTPUT_DIR}\n`); @@ -172,7 +172,7 @@ function convert() { if (fs.existsSync(CLAUDE_SKILLS_DIR)) fs.rmSync(CLAUDE_SKILLS_DIR, { recursive: true }); fs.mkdirSync(CLAUDE_AGENTS_DIR, { recursive: true }); - fs.mkdirSync(path.join(CLAUDE_SKILLS_DIR, 'openagents-standards'), { recursive: true }); + fs.mkdirSync(path.join(CLAUDE_SKILLS_DIR, 'openagents-control-standards'), { recursive: true }); console.log('šŸ“¦ Converting agents...\n'); @@ -183,7 +183,7 @@ function convert() { // Create default context-scout subagent const contextScoutContent = `--- name: context-scout -description: Discovers and recommends OpenAgents context files using glob, read, and grep tools. Use when you need to find OpenAgents standards, guides, or domain knowledge in the .opencode/context directory. +description: Discovers and recommends OpenAgents Control context files using glob, read, and grep tools. Use when you need to find OpenAgents Control standards, guides, or domain knowledge in the .opencode/context directory. tools: Read, Grep, Glob model: haiku permissionMode: plan @@ -191,7 +191,7 @@ permissionMode: plan # ContextScout -You discover and recommend relevant OpenAgents context files from \`.opencode/context/\` based on the user's request. +You discover and recommend relevant OpenAgents Control context files from \`.opencode/context/\` based on the user's request. ## Your Process @@ -205,23 +205,23 @@ You discover and recommend relevant OpenAgents context files from \`.opencode/co contextScoutContent ); - // Create openagents-standards skill + // Create openagents-control-standards skill const skillContent = `--- -name: openagents-standards -description: Automatically triggers before any task to ensure OpenAgents standards and context are loaded. Use when the user asks to create, modify, or analyze anything in this repository. +name: openagents-control-standards +description: Automatically triggers before any task to ensure OpenAgents Control standards and context are loaded. Use when the user asks to create, modify, or analyze anything in this repository. --- -# OpenAgents Standards Loader +# OpenAgents Control Standards Loader Before proceeding with the user's request: -1. Call the \`context-scout\` subagent with the user's request to find relevant OpenAgents context files. +1. Call the \`context-scout\` subagent with the user's request to find relevant OpenAgents Control context files. 2. Read the returned "Critical" and "High" priority files. -3. Apply the OpenAgents standards found to your work. +3. Apply the OpenAgents Control standards found to your work. `; fs.writeFileSync( - path.join(CLAUDE_SKILLS_DIR, 'openagents-standards/SKILL.md'), + path.join(CLAUDE_SKILLS_DIR, 'openagents-control-standards/SKILL.md'), skillContent ); diff --git a/integrations/claude-code/install-claude.sh b/integrations/claude-code/install-claude.sh index a921b23..c423e5d 100755 --- a/integrations/claude-code/install-claude.sh +++ b/integrations/claude-code/install-claude.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash # # install-claude.sh -# Installs OpenAgents to Claude Code with automatic conversion +# Installs OpenAgents Control to Claude Code with automatic conversion # set -euo pipefail @@ -17,10 +17,10 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)" OPENCODE_DIR="$REPO_ROOT/.opencode/agent" CONVERTER_DIR="$SCRIPT_DIR/converter" -PLUGIN_DEST="$HOME/.claude/plugins/openagents-bridge" +PLUGIN_DEST="$HOME/.claude/plugins/openagents-control-bridge" NODE_BIN="${NODE_BIN:-node}" -echo -e "${GREEN}šŸš€ OpenAgents ā†’ Claude Code Installer${NC}" +echo -e "${GREEN}šŸš€ OpenAgents Control ā†’ Claude Code Installer${NC}" echo -e " Source: $OPENCODE_DIR" echo -e " Destination: $PLUGIN_DEST" echo "" @@ -93,7 +93,7 @@ verify() { echo " claude --plugin-dir $PLUGIN_DEST" echo "" echo "Or add to your Claude Code settings for automatic loading:" - echo ' { "plugins": ["openagents-bridge"] }' + echo ' { "plugins": ["openagents-control-bridge"] }' echo "" echo "Verify Claude Code installation:" echo " claude --version" diff --git a/package.json b/package.json index e690370..5637f60 100644 --- a/package.json +++ b/package.json @@ -61,6 +61,6 @@ "license": "MIT", "repository": { "type": "git", - "url": "https://github.com/darrenhinde/OpenAgents.git" + "url": "https://github.com/darrenhinde/OpenAgentsControl.git" } } diff --git a/packages/plugin-abilities/README.md b/packages/plugin-abilities/README.md index 7c3c934..f05aaf1 100644 --- a/packages/plugin-abilities/README.md +++ b/packages/plugin-abilities/README.md @@ -109,7 +109,7 @@ Runs a shell command deterministically. ### Agent -Calls an OpenAgents agent. +Calls an OpenAgents Control agent. ```yaml - id: review diff --git a/packages/plugin-abilities/package.json b/packages/plugin-abilities/package.json index 2b2b386..c541b55 100644 --- a/packages/plugin-abilities/package.json +++ b/packages/plugin-abilities/package.json @@ -37,7 +37,7 @@ "workflows", "agents" ], - "author": "OpenAgents", + "author": "OpenAgents Control", "license": "MIT", "dependencies": { "@opencode-ai/plugin": "^1.0.223", diff --git a/packages/plugin-abilities/test-plugin.ts b/packages/plugin-abilities/test-plugin.ts index 75b3b2a..10da20e 100644 --- a/packages/plugin-abilities/test-plugin.ts +++ b/packages/plugin-abilities/test-plugin.ts @@ -53,7 +53,7 @@ async function main() { console.log('\nšŸš€ Testing ability.run tool...\n') const runResult = await tools['ability.run'].execute({ name: 'hello-world', - inputs: { name: 'OpenAgents' } + inputs: { name: 'OpenAgents Control' } }) console.log(JSON.stringify(runResult, null, 2)) diff --git a/registry.json b/registry.json index f264780..930adb9 100644 --- a/registry.json +++ b/registry.json @@ -1,7 +1,7 @@ { "version": "2.0.0", "schema_version": "2.0.0", - "repository": "https://github.com/darrenhinde/OpenAgents", + "repository": "https://github.com/darrenhinde/OpenAgentsControl", "categories": { "essential": "Minimal components for basic functionality", "standard": "Standard components for typical use", @@ -172,7 +172,7 @@ "name": "OpenRepoManager", "type": "agent", "path": ".opencode/agent/meta/repo-manager.md", - "description": "Meta agent for managing OpenAgents repository development with context-aware planning, task breakdown, and automatic documentation", + "description": "Meta agent for managing OpenAgents Control repository development with context-aware planning, task breakdown, and automatic documentation", "tags": [], "dependencies": [], "category": "meta" @@ -570,7 +570,7 @@ }, { "id": "commit-openagents", - "name": "Commit Openagents", + "name": "Commit OpenAgents Control", "type": "command", "path": ".opencode/command/commit-openagents.md", "description": "description: Smart commit command for opencode-agents repository with automatic validation and conventional commits", @@ -1010,7 +1010,7 @@ "name": "Quick Start", "type": "context", "path": ".opencode/context/openagents-repo/quick-start.md", - "description": "OpenAgents Repository - Quick Start", + "description": "OpenAgents Control Repository - Quick Start", "tags": [], "dependencies": [], "category": "standard" @@ -1915,7 +1915,7 @@ "name": "Navigation", "type": "context", "path": ".opencode/context/openagents-repo/navigation.md", - "description": "OpenAgents Repository Context", + "description": "OpenAgents Control Repository Context", "tags": [], "dependencies": [], "category": "standard" @@ -2273,7 +2273,7 @@ "name": "Building Cli Compact", "type": "context", "path": ".opencode/context/openagents-repo/guides/building-cli-compact.md", - "description": "Building CLIs in OpenAgents: Compact Guide", + "description": "Building CLIs in OpenAgents Control: Compact Guide", "tags": [], "dependencies": [], "category": "standard" diff --git a/scripts/README.md b/scripts/README.md index 4b35432..f8271bb 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -1,6 +1,6 @@ # Scripts -This directory contains utility scripts for the OpenAgents system, organized by function. +This directory contains utility scripts for the OpenAgents Control system, organized by function. ## Directory Structure diff --git a/scripts/tests/README.md b/scripts/tests/README.md index 250fb09..71a1725 100644 --- a/scripts/tests/README.md +++ b/scripts/tests/README.md @@ -27,7 +27,7 @@ bash scripts/tests/test-compatibility.sh **Run remotely:** ```bash -curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/scripts/tests/test-compatibility.sh | bash +curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/scripts/tests/test-compatibility.sh | bash ``` **What it tests:** diff --git a/scripts/tests/test-compatibility.sh b/scripts/tests/test-compatibility.sh index 9d28494..797c82e 100755 --- a/scripts/tests/test-compatibility.sh +++ b/scripts/tests/test-compatibility.sh @@ -162,7 +162,7 @@ fi # Test 12: Network connectivity echo "" echo "Test 12: Network Connectivity" -if curl -fsSL --max-time 5 https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/README.md > /dev/null 2>&1; then +if curl -fsSL --max-time 5 https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/README.md > /dev/null 2>&1; then pass "Network connectivity to GitHub works" else warn "Network connectivity test failed (may be offline)" @@ -175,5 +175,5 @@ echo "ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā• echo "" echo "Your system is compatible with the OpenCode installer." echo "You can safely run:" -echo " curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install.sh | bash" +echo " curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash" echo "" diff --git a/scripts/tests/test-non-interactive.sh b/scripts/tests/test-non-interactive.sh index 13acab7..c16ed6e 100755 --- a/scripts/tests/test-non-interactive.sh +++ b/scripts/tests/test-non-interactive.sh @@ -4,7 +4,7 @@ # Non-Interactive Mode Test Script # Tests the installer behavior when run via pipe (curl | bash) # -# This test catches bugs like: https://github.com/darrenhinde/OpenAgents/issues/XX +# This test catches bugs like: https://github.com/darrenhinde/OpenAgentsControl/issues/XX # where interactive prompts fail silently in piped execution. ############################################################################# diff --git a/update.sh b/update.sh index 4216137..5555012 100755 --- a/update.sh +++ b/update.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash ############################################################################# -# OpenAgents Updater +# OpenAgents Control Updater # Updates existing OpenCode components to latest versions ############################################################################# @@ -15,7 +15,7 @@ CYAN='\033[0;36m' BOLD='\033[1m' NC='\033[0m' -REPO_URL="https://raw.githubusercontent.com/darrenhinde/OpenAgents/main" +REPO_URL="https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main" INSTALL_DIR=".opencode" print_success() { echo -e "${GREEN}āœ“${NC} $1"; } @@ -26,7 +26,7 @@ print_header() { echo -e "${CYAN}${BOLD}" echo "ā•”ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•—" echo "ā•‘ ā•‘" - echo "ā•‘ OpenAgents Updater v1.0.0 ā•‘" + echo "ā•‘ OpenAgents Control Updater v1.0.0 ā•‘" echo "ā•‘ ā•‘" echo "ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•" echo -e "${NC}"