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
This commit is contained in:
parent
9a58a03284
commit
bf02ad0d5c
54 changed files with 360 additions and 249 deletions
32
.github/PROJECT_CLI_GUIDE.md
vendored
32
.github/PROJECT_CLI_GUIDE.md
vendored
|
|
@ -1,6 +1,6 @@
|
||||||
# GitHub Project CLI Guide
|
# 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
|
## 🚀 Quick Start
|
||||||
|
|
||||||
|
|
@ -37,7 +37,7 @@ make idea TITLE="Add support for Cursor" BODY="Extend the framework to work with
|
||||||
**Using gh directly:**
|
**Using gh directly:**
|
||||||
```bash
|
```bash
|
||||||
gh issue create \
|
gh issue create \
|
||||||
--repo darrenhinde/OpenAgents \
|
--repo darrenhinde/OpenAgentsControl \
|
||||||
--title "Add eval harness for small OSS models" \
|
--title "Add eval harness for small OSS models" \
|
||||||
--body "Problem: Need to test agents with smaller models\n\nProposed solution: Create eval harness" \
|
--body "Problem: Need to test agents with smaller models\n\nProposed solution: Create eval harness" \
|
||||||
--label "idea,agents,evals"
|
--label "idea,agents,evals"
|
||||||
|
|
@ -49,28 +49,28 @@ gh issue create \
|
||||||
```bash
|
```bash
|
||||||
make ideas
|
make ideas
|
||||||
# or
|
# or
|
||||||
gh issue list --repo darrenhinde/OpenAgents --label idea
|
gh issue list --repo darrenhinde/OpenAgentsControl --label idea
|
||||||
```
|
```
|
||||||
|
|
||||||
**View specific issue:**
|
**View specific issue:**
|
||||||
```bash
|
```bash
|
||||||
make issue-view NUM=123
|
make issue-view NUM=123
|
||||||
# or
|
# or
|
||||||
gh issue view 123 --repo darrenhinde/OpenAgents
|
gh issue view 123 --repo darrenhinde/OpenAgentsControl
|
||||||
```
|
```
|
||||||
|
|
||||||
**Comment on an idea:**
|
**Comment on an idea:**
|
||||||
```bash
|
```bash
|
||||||
make issue-comment NUM=123 COMMENT="Leaning towards X approach"
|
make issue-comment NUM=123 COMMENT="Leaning towards X approach"
|
||||||
# or
|
# or
|
||||||
gh issue comment 123 --repo darrenhinde/OpenAgents --body "Great idea!"
|
gh issue comment 123 --repo darrenhinde/OpenAgentsControl --body "Great idea!"
|
||||||
```
|
```
|
||||||
|
|
||||||
**Close when done:**
|
**Close when done:**
|
||||||
```bash
|
```bash
|
||||||
make issue-close NUM=123
|
make issue-close NUM=123
|
||||||
# or
|
# or
|
||||||
gh issue close 123 --repo darrenhinde/OpenAgents
|
gh issue close 123 --repo darrenhinde/OpenAgentsControl
|
||||||
```
|
```
|
||||||
|
|
||||||
### Project Board Management
|
### Project Board Management
|
||||||
|
|
@ -92,9 +92,9 @@ make project-items
|
||||||
|
|
||||||
**Add issue to project:**
|
**Add issue to project:**
|
||||||
```bash
|
```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
|
# 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:**
|
**Create new label:**
|
||||||
```bash
|
```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:**
|
**Create milestone:**
|
||||||
```bash
|
```bash
|
||||||
gh milestone create "v0.2 - DX & Examples" \
|
gh milestone create "v0.2 - DX & Examples" \
|
||||||
--repo darrenhinde/OpenAgents \
|
--repo darrenhinde/OpenAgentsControl \
|
||||||
--description "Short-term focus on developer experience"
|
--description "Short-term focus on developer experience"
|
||||||
```
|
```
|
||||||
|
|
||||||
**Attach milestone to issue:**
|
**Attach milestone to issue:**
|
||||||
```bash
|
```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
|
### Bulk Operations
|
||||||
|
|
@ -160,14 +160,14 @@ gh issue edit 123 --repo darrenhinde/OpenAgents --milestone "v0.2 - DX & Example
|
||||||
**Close multiple issues:**
|
**Close multiple issues:**
|
||||||
```bash
|
```bash
|
||||||
for i in 123 124 125; do
|
for i in 123 124 125; do
|
||||||
gh issue close $i --repo darrenhinde/OpenAgents
|
gh issue close $i --repo darrenhinde/OpenAgentsControl
|
||||||
done
|
done
|
||||||
```
|
```
|
||||||
|
|
||||||
**Add label to multiple issues:**
|
**Add label to multiple issues:**
|
||||||
```bash
|
```bash
|
||||||
for i in 123 124 125; do
|
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
|
done
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -197,7 +197,7 @@ make issue-close NUM=42
|
||||||
## 🔗 Resources
|
## 🔗 Resources
|
||||||
|
|
||||||
- **Project Board:** https://github.com/users/darrenhinde/projects/2
|
- **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/
|
- **GitHub CLI Docs:** https://cli.github.com/manual/
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
@ -220,14 +220,14 @@ make issue-close NUM=42
|
||||||
```bash
|
```bash
|
||||||
# Save common queries as shell functions
|
# Save common queries as shell functions
|
||||||
function oa-my-issues() {
|
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:**
|
4. **Combine with git workflow:**
|
||||||
```bash
|
```bash
|
||||||
# Create issue and branch in one go
|
# 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"
|
git checkout -b "fix/issue-$ISSUE"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
||||||
4
.github/workflows/installer-checks.yml
vendored
4
.github/workflows/installer-checks.yml
vendored
|
|
@ -113,6 +113,8 @@ jobs:
|
||||||
run: brew install jq || true
|
run: brew install jq || true
|
||||||
|
|
||||||
- name: Run E2E tests
|
- name: Run E2E tests
|
||||||
|
env:
|
||||||
|
OPENCODE_BRANCH: ${{ github.head_ref || github.ref_name }}
|
||||||
run: bash scripts/tests/test-e2e-install.sh
|
run: bash scripts/tests/test-e2e-install.sh
|
||||||
|
|
||||||
- name: Summary
|
- name: Summary
|
||||||
|
|
@ -166,6 +168,8 @@ jobs:
|
||||||
run: sudo apt-get install -y jq curl
|
run: sudo apt-get install -y jq curl
|
||||||
|
|
||||||
- name: Test ${{ matrix.profile }} profile
|
- name: Test ${{ matrix.profile }} profile
|
||||||
|
env:
|
||||||
|
OPENCODE_BRANCH: ${{ github.head_ref || github.ref_name }}
|
||||||
run: |
|
run: |
|
||||||
TEST_DIR="/tmp/profile-test-${{ matrix.profile }}"
|
TEST_DIR="/tmp/profile-test-${{ matrix.profile }}"
|
||||||
mkdir -p "$TEST_DIR"
|
mkdir -p "$TEST_DIR"
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@
|
||||||
# OpenCode Agent Configuration
|
# OpenCode Agent Configuration
|
||||||
id: repo-manager
|
id: repo-manager
|
||||||
name: OpenRepoManager
|
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
|
category: meta
|
||||||
type: meta
|
type: meta
|
||||||
version: 2.0.0
|
version: 2.0.0
|
||||||
|
|
@ -87,14 +87,14 @@ tags:
|
||||||
<!-- ═══════════════════════════════════════════════════════════════════════════ -->
|
<!-- ═══════════════════════════════════════════════════════════════════════════ -->
|
||||||
|
|
||||||
<context>
|
<context>
|
||||||
<system_context>Meta agent for OpenAgents repository development and maintenance</system_context>
|
<system_context>Meta agent for OpenAgents Control repository development and maintenance</system_context>
|
||||||
<domain_context>Agents, evals, registry, context system, documentation</domain_context>
|
<domain_context>Agents, evals, registry, context system, documentation</domain_context>
|
||||||
<task_context>Context-aware planning, task breakdown, subagent coordination</task_context>
|
<task_context>Context-aware planning, task breakdown, subagent coordination</task_context>
|
||||||
<execution_context>Repository-specific standards enforcement with lazy context loading</execution_context>
|
<execution_context>Repository-specific standards enforcement with lazy context loading</execution_context>
|
||||||
</context>
|
</context>
|
||||||
|
|
||||||
<role>
|
<role>
|
||||||
<identity>Repository Manager - OpenAgents development specialist</identity>
|
<identity>Repository Manager - OpenAgents Control development specialist</identity>
|
||||||
<authority>Coordinates repo development, delegates to specialists, maintains docs</authority>
|
<authority>Coordinates repo development, delegates to specialists, maintains docs</authority>
|
||||||
<scope>Agent creation, eval testing, registry management, context organization</scope>
|
<scope>Agent creation, eval testing, registry management, context organization</scope>
|
||||||
<constraints>Approval-gated, context-first, quality-focused, lazy-loading</constraints>
|
<constraints>Approval-gated, context-first, quality-focused, lazy-loading</constraints>
|
||||||
|
|
|
||||||
|
|
@ -12,6 +12,7 @@ tools:
|
||||||
bash: true
|
bash: true
|
||||||
read: true
|
read: true
|
||||||
grep: true
|
grep: true
|
||||||
|
task: true
|
||||||
permissions:
|
permissions:
|
||||||
bash:
|
bash:
|
||||||
"tsc": "allow"
|
"tsc": "allow"
|
||||||
|
|
@ -26,6 +27,9 @@ permissions:
|
||||||
"*": "deny"
|
"*": "deny"
|
||||||
edit:
|
edit:
|
||||||
"**/*": "deny"
|
"**/*": "deny"
|
||||||
|
task:
|
||||||
|
contextscout: "allow"
|
||||||
|
"*": "deny"
|
||||||
|
|
||||||
# Tags
|
# Tags
|
||||||
tags:
|
tags:
|
||||||
|
|
@ -55,12 +59,31 @@ You are a build validation agent. Detect the project language and perform approp
|
||||||
1. Type check: `cargo check`
|
1. Type check: `cargo check`
|
||||||
2. Build: `cargo build`
|
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
|
## Execution Steps
|
||||||
|
|
||||||
1. **Detect Language** - Check for `package.json`, `requirements.txt`, `go.mod`, or `Cargo.toml`
|
1. **Detect Language** - Check for `package.json`, `requirements.txt`, `go.mod`, or `Cargo.toml`
|
||||||
2. **Type Check** - Run appropriate type checker for the language
|
2. **Context Discovery** (if needed, call ContextScout to find build standards).
|
||||||
3. **Build Check** - Run appropriate build command
|
3. **Type Check** - Run appropriate type checker for the language
|
||||||
4. **Report** - Return errors if any occur, otherwise report success
|
4. **Build Check** - Run appropriate build command
|
||||||
|
5. **Report** - Return errors if any occur, otherwise report success
|
||||||
|
|
||||||
**Rules:**
|
**Rules:**
|
||||||
- Adapt to the detected language
|
- Adapt to the detected language
|
||||||
|
|
|
||||||
|
|
@ -16,6 +16,7 @@ tools:
|
||||||
glob: true
|
glob: true
|
||||||
bash: false
|
bash: false
|
||||||
patch: true
|
patch: true
|
||||||
|
task: true
|
||||||
permissions:
|
permissions:
|
||||||
bash:
|
bash:
|
||||||
"*": "deny"
|
"*": "deny"
|
||||||
|
|
@ -25,6 +26,9 @@ permissions:
|
||||||
"**/*.secret": "deny"
|
"**/*.secret": "deny"
|
||||||
"node_modules/**": "deny"
|
"node_modules/**": "deny"
|
||||||
".git/**": "deny"
|
".git/**": "deny"
|
||||||
|
task:
|
||||||
|
contextscout: "allow"
|
||||||
|
"*": "deny"
|
||||||
|
|
||||||
# Tags
|
# Tags
|
||||||
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.
|
- Do not overcomplicate solutions; keep code modular and well-commented.
|
||||||
- If a subtask is unclear, request clarification before proceeding.
|
- 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
|
## Workflow
|
||||||
|
|
||||||
1. **Receive subtask plan** (with ordered list of subtasks).
|
1. **Receive subtask plan** (with ordered list of subtasks).
|
||||||
2. **Iterate through each subtask in order:**
|
2. **Discover context** (if needed, call ContextScout to find relevant standards).
|
||||||
|
3. **Iterate through each subtask in order:**
|
||||||
- Read the subtask file and requirements.
|
- Read the subtask file and requirements.
|
||||||
- Implement the solution in the appropriate file(s).
|
- Implement the solution in the appropriate file(s).
|
||||||
- Validate completion (e.g., run tests if specified).
|
- Validate completion (e.g., run tests if specified).
|
||||||
- Mark as done.
|
- Mark as done.
|
||||||
3. **Repeat** until all subtasks are finished.
|
4. **Repeat** until all subtasks are finished.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -15,11 +15,15 @@ tools:
|
||||||
bash: false
|
bash: false
|
||||||
edit: false
|
edit: false
|
||||||
write: false
|
write: false
|
||||||
|
task: true
|
||||||
permissions:
|
permissions:
|
||||||
bash:
|
bash:
|
||||||
"*": "deny"
|
"*": "deny"
|
||||||
edit:
|
edit:
|
||||||
"**/*": "deny"
|
"**/*": "deny"
|
||||||
|
task:
|
||||||
|
contextscout: "allow"
|
||||||
|
"*": "deny"
|
||||||
|
|
||||||
# Tags
|
# Tags
|
||||||
tags:
|
tags:
|
||||||
|
|
@ -39,9 +43,28 @@ Responsibilities:
|
||||||
- Load project-specific context for accurate pattern validation
|
- 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?"
|
- 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.
|
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.
|
3. Provide concise review notes with suggested diffs (do not apply changes), including any security concerns.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -15,6 +15,7 @@ tools:
|
||||||
edit: true
|
edit: true
|
||||||
write: true
|
write: true
|
||||||
bash: true
|
bash: true
|
||||||
|
task: true
|
||||||
permissions:
|
permissions:
|
||||||
bash:
|
bash:
|
||||||
"rm -rf *": "ask"
|
"rm -rf *": "ask"
|
||||||
|
|
@ -23,6 +24,9 @@ permissions:
|
||||||
"**/*.env*": "deny"
|
"**/*.env*": "deny"
|
||||||
"**/*.key": "deny"
|
"**/*.key": "deny"
|
||||||
"**/*.secret": "deny"
|
"**/*.secret": "deny"
|
||||||
|
task:
|
||||||
|
contextscout: "allow"
|
||||||
|
"*": "deny"
|
||||||
|
|
||||||
# Tags
|
# Tags
|
||||||
tags:
|
tags:
|
||||||
|
|
@ -44,7 +48,25 @@ Responsibilities:
|
||||||
- Ensure tests cover acceptance criteria, edge cases, and error handling.
|
- Ensure tests cover acceptance criteria, edge cases, and error handling.
|
||||||
- Author and run bun tests for the code before handoff.
|
- 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:
|
1. Propose a test plan:
|
||||||
- The objective, state the behaviors to be tested.
|
- The objective, state the behaviors to be tested.
|
||||||
|
|
|
||||||
|
|
@ -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/code-review.md`
|
||||||
- `.opencode/context/core/workflows/delegation.md`
|
- `.opencode/context/core/workflows/delegation.md`
|
||||||
|
|
||||||
**OpenAgents Repo:**
|
**OpenAgents Control Repo:**
|
||||||
- `.opencode/context/openagents-repo/quick-start.md`
|
- `.opencode/context/openagents-repo/quick-start.md`
|
||||||
- `.opencode/context/openagents-repo/core-concepts/agents.md`
|
- `.opencode/context/openagents-repo/core-concepts/agents.md`
|
||||||
- `.opencode/context/openagents-repo/core-concepts/evals.md`
|
- `.opencode/context/openagents-repo/core-concepts/evals.md`
|
||||||
|
|
|
||||||
|
|
@ -15,6 +15,7 @@ tools:
|
||||||
edit: true
|
edit: true
|
||||||
write: true
|
write: true
|
||||||
bash: false
|
bash: false
|
||||||
|
task: true
|
||||||
permissions:
|
permissions:
|
||||||
bash:
|
bash:
|
||||||
"*": "deny"
|
"*": "deny"
|
||||||
|
|
@ -24,6 +25,9 @@ permissions:
|
||||||
"**/*.env*": "deny"
|
"**/*.env*": "deny"
|
||||||
"**/*.key": "deny"
|
"**/*.key": "deny"
|
||||||
"**/*.secret": "deny"
|
"**/*.secret": "deny"
|
||||||
|
task:
|
||||||
|
contextscout: "allow"
|
||||||
|
"*": "deny"
|
||||||
|
|
||||||
# Tags
|
# Tags
|
||||||
tags:
|
tags:
|
||||||
|
|
@ -39,9 +43,27 @@ Responsibilities:
|
||||||
- Maintain consistency with naming conventions and architecture decisions
|
- Maintain consistency with naming conventions and architecture decisions
|
||||||
- Generate concise, high-signal docs; prefer examples and short lists
|
- 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.
|
2. Apply edits and summarize changes.
|
||||||
|
|
||||||
Constraints:
|
Constraints:
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@
|
||||||
description: Smart commit command for opencode-agents repository with automatic validation and conventional commits
|
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.
|
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.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Validate Repository
|
# 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
|
## Usage
|
||||||
|
|
||||||
|
|
@ -60,7 +60,7 @@ The command generates a detailed report showing:
|
||||||
|
|
||||||
## Instructions
|
## 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
|
### Step 1: Validate Registry JSON
|
||||||
|
|
||||||
|
|
@ -182,7 +182,7 @@ Based on findings, suggest:
|
||||||
## Example Report Format
|
## Example Report Format
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
# OpenAgents Repository Validation Report
|
# OpenAgents Control Repository Validation Report
|
||||||
|
|
||||||
Generated: 2025-11-19 14:30:00
|
Generated: 2025-11-19 14:30:00
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -15,9 +15,9 @@
|
||||||
**Token count**: ~250 tokens
|
**Token count**: ~250 tokens
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
# OpenAgents Repository Navigation
|
# OpenAgents Control Repository Navigation
|
||||||
|
|
||||||
**Purpose**: Navigate OpenAgents repository context
|
**Purpose**: Navigate OpenAgents Control repository context
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -51,7 +51,7 @@
|
||||||
**YES** → Use **Pattern A (Function-Based)**
|
**YES** → Use **Pattern A (Function-Based)**
|
||||||
|
|
||||||
Examples:
|
Examples:
|
||||||
- `openagents-repo/` - OpenAgents repository work
|
- `openagents-repo/` - OpenAgents Control repository work
|
||||||
- `myproject-repo/` - Your project's repository
|
- `myproject-repo/` - Your project's repository
|
||||||
|
|
||||||
**NO** → Continue to Step 2
|
**NO** → Continue to Step 2
|
||||||
|
|
|
||||||
|
|
@ -79,4 +79,4 @@ core/
|
||||||
## Related Context
|
## Related Context
|
||||||
|
|
||||||
- **Development** → `../development/navigation.md`
|
- **Development** → `../development/navigation.md`
|
||||||
- **OpenAgents Repo** → `../openagents-repo/navigation.md`
|
- **OpenAgents Control Repo** → `../openagents-repo/navigation.md`
|
||||||
|
|
|
||||||
|
|
@ -37,4 +37,4 @@
|
||||||
## Related
|
## Related
|
||||||
|
|
||||||
- **Standards** → `../standards/navigation.md`
|
- **Standards** → `../standards/navigation.md`
|
||||||
- **OpenAgents Delegation** → `../../openagents-repo/guides/subagent-invocation.md`
|
- **OpenAgents Control Delegation** → `../../openagents-repo/guides/subagent-invocation.md`
|
||||||
|
|
|
||||||
|
|
@ -9,7 +9,7 @@
|
||||||
```
|
```
|
||||||
.opencode/context/
|
.opencode/context/
|
||||||
├── core/ # Universal standards & workflows
|
├── core/ # Universal standards & workflows
|
||||||
├── openagents-repo/ # OpenAgents repository work
|
├── openagents-repo/ # OpenAgents Control repository work
|
||||||
├── development/ # Software development (all stacks)
|
├── development/ # Software development (all stacks)
|
||||||
├── ui/ # Visual design & UX
|
├── ui/ # Visual design & UX
|
||||||
├── content-creation/ # Content creation (all formats)
|
├── content-creation/ # Content creation (all formats)
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Core Concept: Agents
|
# 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
|
**Priority**: CRITICAL - Load this before working with agents
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
@ -160,14 +160,14 @@ Agents:
|
||||||
|
|
||||||
## Claude Code Interop (Optional)
|
## 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/`
|
- **Subagents**: Project helpers in `.claude/agents/`
|
||||||
- **Skills**: Auto-invoked guidance in `.claude/skills/`
|
- **Skills**: Auto-invoked guidance in `.claude/skills/`
|
||||||
- **Hooks**: Shell commands on lifecycle events (use sparingly)
|
- **Hooks**: Shell commands on lifecycle events (use sparingly)
|
||||||
- **Plugins**: Share agents/skills/hooks across projects
|
- **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.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -7,7 +7,7 @@
|
||||||
|
|
||||||
## What Is the Registry?
|
## 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
|
- **Agents** - AI agent prompts
|
||||||
- **Subagents** - Delegated specialists
|
- **Subagents** - Delegated specialists
|
||||||
- **Commands** - Slash commands
|
- **Commands** - Slash commands
|
||||||
|
|
|
||||||
|
|
@ -7,7 +7,7 @@ Status: in_progress
|
||||||
|
|
||||||
## Task Overview
|
## 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
|
## 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
|
5. Update progress tracking as you complete steps
|
||||||
|
|
||||||
**Your Task**:
|
**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**:
|
**Approach**:
|
||||||
1. **Load Context**: Read all context files listed above to understand:
|
1. **Load Context**: Read all context files listed above to understand:
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
# Building CLIs in OpenAgents: Compact Guide
|
# Building CLIs in OpenAgents Control: Compact Guide
|
||||||
|
|
||||||
**Category**: 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)
|
**Framework**: FAB (Features, Advantages, Benefits)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
|
||||||
|
|
@ -238,7 +238,7 @@ Save this as: `scripts/registry/validate-profile-coverage.sh`
|
||||||
# Install to temp directory
|
# Install to temp directory
|
||||||
mkdir -p /tmp/test-install
|
mkdir -p /tmp/test-install
|
||||||
cd /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
|
# Check if agent was installed
|
||||||
ls .opencode/agent/category/your-agent.md
|
ls .opencode/agent/category/your-agent.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
|
**Last Updated**: 2026-01-13
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,4 @@
|
||||||
# OpenAgents Repository - Quick Start
|
# OpenAgents Control Repository - Quick Start
|
||||||
|
|
||||||
**Purpose**: Get oriented in this repo in 2 minutes
|
**Purpose**: Get oriented in this repo in 2 minutes
|
||||||
|
|
||||||
|
|
@ -6,7 +6,7 @@
|
||||||
|
|
||||||
## What Is This Repo?
|
## 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)
|
- **Category-based agents** (core, development, content, data, product, learning)
|
||||||
- **Eval framework** for testing agent behavior
|
- **Eval framework** for testing agent behavior
|
||||||
- **Registry system** for component distribution
|
- **Registry system** for component distribution
|
||||||
|
|
|
||||||
|
|
@ -14,24 +14,24 @@
|
||||||
|
|
||||||
### macOS / Linux
|
### macOS / Linux
|
||||||
```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 (Git Bash)
|
### Windows (Git Bash)
|
||||||
```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)
|
### Windows (PowerShell)
|
||||||
```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
|
& "C:\Program Files\Git\bin\bash.exe" install.sh essential
|
||||||
```
|
```
|
||||||
|
|
||||||
## Test Your System
|
## Test Your System
|
||||||
|
|
||||||
```bash
|
```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
|
## 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`
|
1. Run compatibility test: `bash scripts/tests/test-compatibility.sh`
|
||||||
2. Check bash version: `bash --version`
|
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)
|
||||||
|
|
|
||||||
60
README.md
60
README.md
|
|
@ -1,13 +1,13 @@
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
# OpenAgents
|
# OpenAgents Control
|
||||||
|
|
||||||
### AI agent framework for plan-first development workflows with approval-based execution
|
### AI agent framework for plan-first development workflows with approval-based execution
|
||||||
|
|
||||||
[](https://github.com/darrenhinde/OpenAgents/stargazers)
|
[](https://github.com/darrenhinde/OpenAgentsControl/stargazers)
|
||||||
[](https://x.com/DarrenBuildsAI)
|
[](https://x.com/DarrenBuildsAI)
|
||||||
[](https://opensource.org/licenses/MIT)
|
[](https://opensource.org/licenses/MIT)
|
||||||
[](https://github.com/darrenhinde/OpenAgents/commits/main)
|
[](https://github.com/darrenhinde/OpenAgentsControl/commits/main)
|
||||||
[](docs/contributing/CONTRIBUTING.md)
|
[](docs/contributing/CONTRIBUTING.md)
|
||||||
[](https://buymeacoffee.com/darrenhinde)
|
[](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.
|
> **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?
|
## Why Use This?
|
||||||
|
|
@ -52,7 +52,7 @@ https://opencode.ai/docs#
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Download the installer
|
# 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
|
# Run interactively
|
||||||
bash install.sh
|
bash install.sh
|
||||||
|
|
@ -64,7 +64,7 @@ bash install.sh
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Download the installer
|
# 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
|
# Run interactively
|
||||||
bash install.sh
|
bash install.sh
|
||||||
|
|
@ -76,7 +76,7 @@ bash install.sh
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
# Download the script
|
# 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
|
# Run with Git Bash
|
||||||
& "C:\Program Files\Git\bin\bash.exe" install.sh
|
& "C:\Program Files\Git\bin\bash.exe" install.sh
|
||||||
|
|
@ -107,19 +107,19 @@ The installer offers:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Essential - Minimal essentials (9 components)
|
# 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)
|
# 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)
|
# 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)
|
# 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)
|
# 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
|
||||||
```
|
```
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -128,7 +128,7 @@ curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
# Download script
|
# 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
|
# Essential profile
|
||||||
& "C:\Program Files\Git\bin\bash.exe" install.sh essential
|
& "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**
|
**Option C: Manual Install**
|
||||||
```bash
|
```bash
|
||||||
# Clone this repository
|
# Clone this repository
|
||||||
git clone https://github.com/darrenhinde/OpenAgents.git
|
git clone https://github.com/darrenhinde/OpenAgentsControl.git
|
||||||
cd OpenAgents
|
cd OpenAgentsControl
|
||||||
|
|
||||||
# Install to OpenCode directory (global)
|
# Install to OpenCode directory (global)
|
||||||
mkdir -p ~/.opencode
|
mkdir -p ~/.opencode
|
||||||
|
|
@ -316,7 +316,7 @@ The System Builder is an interactive tool that generates complete `.opencode` ar
|
||||||
### Quick Start
|
### Quick Start
|
||||||
```bash
|
```bash
|
||||||
# Install advanced profile (includes system builder)
|
# 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
|
# Run the interactive builder
|
||||||
/build-context-system
|
/build-context-system
|
||||||
|
|
@ -363,7 +363,7 @@ cd ~/.opencode/plugin
|
||||||
npm install
|
npm install
|
||||||
|
|
||||||
# Configure
|
# Configure
|
||||||
cd ~/OpenAgents
|
cd ~/OpenAgentsControl
|
||||||
cp env.example .env
|
cp env.example .env
|
||||||
# Edit .env with TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID
|
# Edit .env with TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID
|
||||||
```
|
```
|
||||||
|
|
@ -384,7 +384,7 @@ cd ~/.opencode/tool
|
||||||
npm install
|
npm install
|
||||||
|
|
||||||
# Configure
|
# Configure
|
||||||
cd ~/OpenAgents
|
cd ~/OpenAgentsControl
|
||||||
cp env.example .env
|
cp env.example .env
|
||||||
# Edit .env with GEMINI_API_KEY
|
# Edit .env with GEMINI_API_KEY
|
||||||
```
|
```
|
||||||
|
|
@ -393,14 +393,14 @@ cp env.example .env
|
||||||
|
|
||||||
### 🤖 Use with Claude Code (Beta)
|
### 🤖 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.
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary><b>For This Repository (Contributors)</b></summary>
|
<summary><b>For This Repository (Contributors)</b></summary>
|
||||||
|
|
||||||
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
|
```bash
|
||||||
cd /path/to/opencode-agents
|
cd /path/to/opencode-agents
|
||||||
|
|
@ -410,23 +410,23 @@ claude
|
||||||
Claude will automatically:
|
Claude will automatically:
|
||||||
- Load the `openagents-standards` Skill
|
- Load the `openagents-standards` Skill
|
||||||
- Use `context-scout` to find relevant context files
|
- 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:
|
**If it doesn't auto-trigger**, restart Claude Code and start your request with:
|
||||||
```
|
```
|
||||||
[Use OpenAgents standards]
|
[Use OpenAgents Control standards]
|
||||||
```
|
```
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary><b>For Your Own OpenAgents Projects</b></summary>
|
<summary><b>For Your Own OpenAgents Control Projects</b></summary>
|
||||||
|
|
||||||
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
|
```bash
|
||||||
# One-line installer (recommended)
|
# 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
|
# Use with Claude Code
|
||||||
claude --plugin-dir ~/.claude/plugins/openagents-bridge
|
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
|
- The installer automatically converts your `.opencode/` files to Claude format
|
||||||
- Converts agents, subagents, and creates context-scout skill
|
- Converts agents, subagents, and creates context-scout skill
|
||||||
- Claude automatically discovers and follows your patterns
|
- Claude automatically discovers and follows your patterns
|
||||||
- No duplication - works with your existing OpenAgents setup
|
- No duplication - works with your existing OpenAgents Control setup
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -460,7 +460,7 @@ cd /path/to/opencode-agents/integrations/claude-code
|
||||||
|---------|-------------|
|
|---------|-------------|
|
||||||
| `claude` | Start interactive session |
|
| `claude` | Start interactive session |
|
||||||
| `claude "request"` | One-shot request |
|
| `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 --print-plugins` | Show loaded plugins |
|
||||||
| `claude --debug` | Debug mode (shows plugin loading) |
|
| `claude --debug` | Debug mode (shows plugin loading) |
|
||||||
|
|
||||||
|
|
@ -511,7 +511,7 @@ mkdir -p ~/.opencode/agent/core
|
||||||
|
|
||||||
# Download specific agent
|
# Download specific agent
|
||||||
curl -o ~/.opencode/agent/core/opencoder.md \
|
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
|
./update.sh
|
||||||
|
|
||||||
# Or re-run the installer
|
# 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
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
|
||||||
12
ROADMAP.md
12
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:
|
Create an issue with the `idea` label:
|
||||||
```bash
|
```bash
|
||||||
gh issue create \
|
gh issue create \
|
||||||
--repo darrenhinde/OpenAgents \
|
--repo darrenhinde/OpenAgentsControl \
|
||||||
--title "Your idea title" \
|
--title "Your idea title" \
|
||||||
--body "Description of your idea..." \
|
--body "Description of your idea..." \
|
||||||
--label "idea"
|
--label "idea"
|
||||||
|
|
@ -61,10 +61,10 @@ gh issue create \
|
||||||
### Track Progress
|
### Track Progress
|
||||||
```bash
|
```bash
|
||||||
# List all ideas
|
# List all ideas
|
||||||
gh issue list --repo darrenhinde/OpenAgents --label idea
|
gh issue list --repo darrenhinde/OpenAgentsControl --label idea
|
||||||
|
|
||||||
# View specific issue
|
# View specific issue
|
||||||
gh issue view 123 --repo darrenhinde/OpenAgents
|
gh issue view 123 --repo darrenhinde/OpenAgentsControl
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
## Overview
|
## 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
|
```markdown
|
||||||
@.opencode/context/path/to/file.md
|
@.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
|
### Problem: Local vs Global Installations
|
||||||
|
|
||||||
Users can install OpenAgents in two ways:
|
Users can install OpenAgents Control in two ways:
|
||||||
|
|
||||||
**Local Install:**
|
**Local Install:**
|
||||||
```bash
|
```bash
|
||||||
|
|
|
||||||
|
|
@ -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
|
## 📚 Documentation Index
|
||||||
|
|
||||||
|
|
@ -36,7 +36,7 @@ Welcome to the OpenAgents documentation! This directory contains all documentati
|
||||||
### For Contributors
|
### For Contributors
|
||||||
- Read the [Contributing Guide](contributing/CONTRIBUTING.md)
|
- Read the [Contributing Guide](contributing/CONTRIBUTING.md)
|
||||||
- Review the [Code of Conduct](contributing/CODE_OF_CONDUCT.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
|
### For Advanced Users
|
||||||
- Study the [Agent System Blueprint](features/agent-system-blueprint.md)
|
- Study the [Agent System Blueprint](features/agent-system-blueprint.md)
|
||||||
|
|
@ -67,7 +67,7 @@ docs/
|
||||||
|
|
||||||
### I want to...
|
### I want to...
|
||||||
|
|
||||||
**...install OpenAgents**
|
**...install OpenAgents Control**
|
||||||
→ [Installation Guide](getting-started/installation.md)
|
→ [Installation Guide](getting-started/installation.md)
|
||||||
|
|
||||||
**...understand collision handling**
|
**...understand collision handling**
|
||||||
|
|
@ -83,20 +83,20 @@ docs/
|
||||||
→ [Contributing Guide](contributing/CONTRIBUTING.md)
|
→ [Contributing Guide](contributing/CONTRIBUTING.md)
|
||||||
|
|
||||||
**...report a bug or request a feature**
|
**...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
|
## 💡 Additional Resources
|
||||||
|
|
||||||
- **Main README**: [../README.md](../README.md)
|
- **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
|
- **OpenCode CLI Docs**: https://opencode.ai/docs
|
||||||
- **Component Registry**: [../registry.json](../registry.json)
|
- **Component Registry**: [../registry.json](../registry.json)
|
||||||
|
|
||||||
## 🤝 Community
|
## 🤝 Community
|
||||||
|
|
||||||
- **Issues**: [Report bugs or request features](https://github.com/darrenhinde/OpenAgents/issues)
|
- **Issues**: [Report bugs or request features](https://github.com/darrenhinde/OpenAgentsControl/issues)
|
||||||
- **Discussions**: [Ask questions and share ideas](https://github.com/darrenhinde/OpenAgents/discussions)
|
- **Discussions**: [Ask questions and share ideas](https://github.com/darrenhinde/OpenAgentsControl/discussions)
|
||||||
- **Pull Requests**: [Contribute code](https://github.com/darrenhinde/OpenAgents/pulls)
|
- **Pull Requests**: [Contribute code](https://github.com/darrenhinde/OpenAgentsControl/pulls)
|
||||||
|
|
||||||
## 📝 License
|
## 📝 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).
|
||||||
|
|
|
||||||
|
|
@ -10,7 +10,7 @@
|
||||||
|
|
||||||
## Overview
|
## 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
|
### What's New in v2.0
|
||||||
|
|
||||||
|
|
@ -24,7 +24,7 @@ The Repository Manager is a meta agent specifically designed for managing develo
|
||||||
|
|
||||||
## Purpose
|
## 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
|
- ✅ Updating the registry
|
||||||
- ✅ Managing context files
|
- ✅ Managing context files
|
||||||
- ✅ Updating documentation
|
- ✅ Updating documentation
|
||||||
- ✅ Any OpenAgents repository development
|
- ✅ Any OpenAgents Control repository development
|
||||||
|
|
||||||
Don't use `repo-manager` for:
|
Don't use `repo-manager` for:
|
||||||
- ❌ Working on user projects (use `openagent` instead)
|
- ❌ Working on user projects (use `openagent` instead)
|
||||||
|
|
|
||||||
|
|
@ -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.
|
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.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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.
|
Thank you for your interest in contributing! This guide will help you add new components to the registry and understand the repository structure.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,8 @@
|
||||||
# Development Guide
|
# 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
|
## Table of Contents
|
||||||
|
|
||||||
|
|
@ -30,8 +30,8 @@ This guide covers everything you need to know to develop agents, commands, tools
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Clone the repository
|
# Clone the repository
|
||||||
git clone https://github.com/darrenhinde/OpenAgents.git
|
git clone https://github.com/darrenhinde/OpenAgentsControl.git
|
||||||
cd OpenAgents
|
cd OpenAgentsControl
|
||||||
|
|
||||||
# Install dependencies for testing framework
|
# Install dependencies for testing framework
|
||||||
cd evals/framework
|
cd evals/framework
|
||||||
|
|
@ -74,7 +74,7 @@ opencode-agents/
|
||||||
│ │ ├── system-builder/ # System building subagents
|
│ │ ├── system-builder/ # System building subagents
|
||||||
│ │ └── utils/ # Utility subagents
|
│ │ └── utils/ # Utility subagents
|
||||||
│ ├── command/ # Slash commands
|
│ ├── command/ # Slash commands
|
||||||
│ │ ├── openagents/ # OpenAgents-specific commands
|
│ │ ├── openagents/ # OpenAgents Control-specific commands
|
||||||
│ │ │ └── new-agents/ # Agent creation system ⭐
|
│ │ │ └── new-agents/ # Agent creation system ⭐
|
||||||
│ │ └── prompt-engineering/ # Prompt optimization commands
|
│ │ └── prompt-engineering/ # Prompt optimization commands
|
||||||
│ ├── context/ # Context files
|
│ ├── context/ # Context files
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
# Abilities System - Implementation Plan
|
# Abilities System - Implementation Plan
|
||||||
|
|
||||||
> **Status:** Planning Complete - Ready for Implementation
|
> **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
|
> **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 |
|
| Hook enforcement | AI **cannot** skip steps |
|
||||||
| Script steps | Deterministic execution |
|
| Script steps | Deterministic execution |
|
||||||
| Validation rules | Guaranteed completion |
|
| 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 |
|
| Approval gates | Human-in-the-loop where needed |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
@ -258,7 +258,7 @@ settings:
|
||||||
```yaml
|
```yaml
|
||||||
- id: review
|
- id: review
|
||||||
type: agent
|
type: agent
|
||||||
agent: reviewer # Agent name (from OpenAgents)
|
agent: reviewer # Agent name (from OpenAgents Control)
|
||||||
prompt: "Review this code..." # Task for agent
|
prompt: "Review this code..." # Task for agent
|
||||||
context: # Additional context (optional)
|
context: # Additional context (optional)
|
||||||
- ./src/
|
- ./src/
|
||||||
|
|
@ -733,7 +733,7 @@ steps:
|
||||||
| Abilities load correctly | All YAML files parse without error |
|
| Abilities load correctly | All YAML files parse without error |
|
||||||
| Validation catches errors | Invalid YAMLs rejected with clear messages |
|
| Validation catches errors | Invalid YAMLs rejected with clear messages |
|
||||||
| Scripts execute | Exit codes captured, validation works |
|
| 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 |
|
| Enforcement works | Cannot skip steps when strict |
|
||||||
| Approvals work | Human gate blocks until approved |
|
| Approvals work | Human gate blocks until approved |
|
||||||
| Context passes | Prior step outputs available to next |
|
| Context passes | Prior step outputs available to next |
|
||||||
|
|
@ -742,7 +742,7 @@ steps:
|
||||||
|
|
||||||
## References
|
## 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
|
- [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) - Plugin patterns
|
||||||
- [OpenCode Skills](https://opencode.ai/docs/skills/) - Current skill system
|
- [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)
|
- [Scott Spence - Making Skills Reliable](https://scottspence.com/posts/how-to-make-claude-code-skills-activate-reliably)
|
||||||
|
|
|
||||||
|
|
@ -9,7 +9,7 @@
|
||||||
The system builder is included in the **Advanced** profile:
|
The system builder is included in the **Advanced** profile:
|
||||||
|
|
||||||
```bash
|
```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:**
|
**What you get:**
|
||||||
|
|
@ -25,7 +25,7 @@ Already have `core`, `developer`, or `full` profile? Add system builder:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Run advanced profile
|
# 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:
|
# When prompted about collisions:
|
||||||
# Choose: 1) Skip existing
|
# Choose: 1) Skip existing
|
||||||
|
|
|
||||||
|
|
@ -15,7 +15,7 @@ An **interactive AI system generator** that creates complete `.opencode` archite
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Install Advanced profile (includes system builder)
|
# 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:**
|
**What you get:**
|
||||||
|
|
@ -33,7 +33,7 @@ Already have `developer` or `full` profile? Add system builder:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Run advanced profile
|
# 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:
|
# When prompted about collisions:
|
||||||
# Choose: 1) Skip existing
|
# Choose: 1) Skip existing
|
||||||
|
|
@ -178,7 +178,7 @@ When you install **advanced** profile, you get:
|
||||||
|
|
||||||
**Installation:**
|
**Installation:**
|
||||||
```bash
|
```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:**
|
**Usage:**
|
||||||
|
|
|
||||||
|
|
@ -15,7 +15,7 @@ An **interactive AI system generator** that creates complete `.opencode` archite
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Install Advanced profile (includes system builder)
|
# 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:**
|
**What you get:**
|
||||||
|
|
@ -33,7 +33,7 @@ Already have `developer` or `full` profile? Add system builder:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Run advanced profile
|
# 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:
|
# When prompted about collisions:
|
||||||
# Choose: 1) Skip existing
|
# Choose: 1) Skip existing
|
||||||
|
|
@ -360,7 +360,7 @@ When you install **advanced** profile, you get:
|
||||||
|
|
||||||
**Installation:**
|
**Installation:**
|
||||||
```bash
|
```bash
|
||||||
curl -fsSL .../install.sh | bash -s advanced
|
curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced
|
||||||
```
|
```
|
||||||
|
|
||||||
**Usage:**
|
**Usage:**
|
||||||
|
|
|
||||||
|
|
@ -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
|
```bash
|
||||||
# Interactive mode - choose components
|
# 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
|
# 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.
|
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:
|
Run the installer without arguments to get an interactive experience:
|
||||||
|
|
||||||
```bash
|
```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:**
|
**Interactive Flow:**
|
||||||
|
|
@ -55,26 +55,26 @@ Install a pre-configured set of components:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Essential - Minimal setup with core agents
|
# 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
|
# 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
|
# 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
|
# 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
|
# 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)
|
### 3. Download & Run (For Offline or Repeated Use)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Download the installer
|
# 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
|
# Make it executable
|
||||||
chmod +x install.sh
|
chmod +x install.sh
|
||||||
|
|
@ -239,7 +239,7 @@ Installation directory is determined by (highest to lowest priority):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Standard installation
|
# 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
|
# Global installation
|
||||||
./install.sh developer --install-dir ~/.config/opencode
|
./install.sh developer --install-dir ~/.config/opencode
|
||||||
|
|
@ -252,7 +252,7 @@ sudo ./install.sh developer --install-dir /opt/opencode
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Standard installation
|
# 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)
|
# Global installation (XDG standard)
|
||||||
./install.sh developer --install-dir ~/.config/opencode
|
./install.sh developer --install-dir ~/.config/opencode
|
||||||
|
|
@ -265,7 +265,7 @@ curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Standard installation
|
# 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
|
# Global installation
|
||||||
./install.sh developer --install-dir ~/.config/opencode
|
./install.sh developer --install-dir ~/.config/opencode
|
||||||
|
|
@ -278,7 +278,7 @@ curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgents/main/install
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Same as Linux
|
# 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
|
# Global installation
|
||||||
./install.sh developer --install-dir ~/.config/opencode
|
./install.sh developer --install-dir ~/.config/opencode
|
||||||
|
|
@ -580,7 +580,7 @@ export OPENCODE_BRANCH=main
|
||||||
### Example 1: First-Time Local Installation
|
### Example 1: First-Time Local Installation
|
||||||
```bash
|
```bash
|
||||||
# Download and run installer
|
# 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
|
# Result: Installs to .opencode/ in current directory
|
||||||
```
|
```
|
||||||
|
|
@ -656,14 +656,14 @@ After installation:
|
||||||
|
|
||||||
- **View installer help:** `./install.sh --help`
|
- **View installer help:** `./install.sh --help`
|
||||||
- **List components:** `./install.sh --list`
|
- **List components:** `./install.sh --list`
|
||||||
- **Documentation:** [GitHub Repository](https://github.com/darrenhinde/OpenAgents)
|
- **Documentation:** [GitHub Repository](https://github.com/darrenhinde/OpenAgentsControl)
|
||||||
- **Report issues:** [GitHub Issues](https://github.com/darrenhinde/OpenAgents/issues)
|
- **Report issues:** [GitHub Issues](https://github.com/darrenhinde/OpenAgentsControl/issues)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Summary
|
## Summary
|
||||||
|
|
||||||
The OpenAgents installer provides:
|
The OpenAgents Control installer provides:
|
||||||
|
|
||||||
✅ **Flexible installation locations** - Local, global, or custom
|
✅ **Flexible installation locations** - Local, global, or custom
|
||||||
✅ **Multiple installation methods** - Interactive, profile-based, 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
|
✅ **Safe updates** - Collision detection and backup options
|
||||||
✅ **Easy to use** - Simple commands, clear prompts
|
✅ **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!
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Platform Compatibility Guide
|
# 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
|
## Supported Platforms
|
||||||
|
|
||||||
|
|
@ -11,10 +11,10 @@ The OpenAgents installer is designed to work across multiple platforms and bash
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Standard installation
|
# 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
|
# 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:**
|
**Dependencies:**
|
||||||
|
|
@ -32,10 +32,10 @@ brew install curl jq
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Standard installation
|
# 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
|
# 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:**
|
**Dependencies:**
|
||||||
|
|
@ -90,10 +90,10 @@ apk add curl jq bash
|
||||||
**Run Installer:**
|
**Run Installer:**
|
||||||
```bash
|
```bash
|
||||||
# Standard installation
|
# 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
|
# 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)
|
#### Option 2: WSL (Windows Subsystem for Linux)
|
||||||
|
|
@ -110,7 +110,7 @@ wsl --install
|
||||||
**Run Installer:**
|
**Run Installer:**
|
||||||
```bash
|
```bash
|
||||||
# In WSL terminal
|
# 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:**
|
**Dependencies:**
|
||||||
|
|
@ -125,7 +125,7 @@ sudo apt-get install curl jq
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
# Download the script
|
# 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
|
# Run with Git Bash
|
||||||
& "C:\Program Files\Git\bin\bash.exe" install.sh core
|
& "C:\Program Files\Git\bin\bash.exe" install.sh core
|
||||||
|
|
@ -200,15 +200,15 @@ Run the compatibility test to verify your system:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Download and run the test
|
# 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:
|
Or manually:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Clone the repo
|
# Clone the repo
|
||||||
git clone https://github.com/darrenhinde/OpenAgents.git
|
git clone https://github.com/darrenhinde/OpenAgentsControl.git
|
||||||
cd OpenAgents
|
cd OpenAgentsControl
|
||||||
|
|
||||||
# Run the test
|
# Run the test
|
||||||
bash scripts/tests/test-compatibility.sh
|
bash scripts/tests/test-compatibility.sh
|
||||||
|
|
@ -232,7 +232,7 @@ The test checks:
|
||||||
**Status:** ✅ **FIXED in v1.1.0**
|
**Status:** ✅ **FIXED in v1.1.0**
|
||||||
**Solution:** Update to the latest installer:
|
**Solution:** Update to the latest installer:
|
||||||
```bash
|
```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
|
bash install.sh developer
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -246,7 +246,7 @@ bash install.sh developer
|
||||||
**Cause:** Using bash version < 4.0
|
**Cause:** Using bash version < 4.0
|
||||||
**Solution:** This should be fixed in the latest version. Update the installer:
|
**Solution:** This should be fixed in the latest version. Update the installer:
|
||||||
```bash
|
```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
|
bash install.sh developer
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -303,7 +303,7 @@ sudo bash install.sh core
|
||||||
**Solution:** Use Git Bash or WSL:
|
**Solution:** Use Git Bash or WSL:
|
||||||
```powershell
|
```powershell
|
||||||
# Download first
|
# 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
|
# Run with Git Bash
|
||||||
& "C:\Program Files\Git\bin\bash.exe" install.sh
|
& "C:\Program Files\Git\bin\bash.exe" install.sh
|
||||||
|
|
@ -331,8 +331,8 @@ If you can't use the installer:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 1. Clone or download the repository
|
# 1. Clone or download the repository
|
||||||
git clone https://github.com/darrenhinde/OpenAgents.git
|
git clone https://github.com/darrenhinde/OpenAgentsControl.git
|
||||||
cd OpenAgents
|
cd OpenAgentsControl
|
||||||
|
|
||||||
# 2. Copy to OpenCode directory
|
# 2. Copy to OpenCode directory
|
||||||
mkdir -p ~/.opencode
|
mkdir -p ~/.opencode
|
||||||
|
|
@ -355,7 +355,7 @@ If you encounter issues:
|
||||||
|
|
||||||
1. **Run the compatibility test:**
|
1. **Run the compatibility test:**
|
||||||
```bash
|
```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:**
|
2. **Check your bash version:**
|
||||||
|
|
@ -370,7 +370,7 @@ If you encounter issues:
|
||||||
```
|
```
|
||||||
|
|
||||||
4. **Report 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
|
- Include: Platform, Bash version, Error message
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
|
||||||
|
|
@ -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.
|
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)
|
## 2. Topics (Add All 16)
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -9,7 +9,7 @@
|
||||||
|
|
||||||
## Overview
|
## 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
|
## Test Suites
|
||||||
|
|
||||||
|
|
|
||||||
14
install.sh
14
install.sh
|
|
@ -1,7 +1,7 @@
|
||||||
#!/usr/bin/env bash
|
#!/usr/bin/env bash
|
||||||
|
|
||||||
#############################################################################
|
#############################################################################
|
||||||
# OpenAgents Installer
|
# OpenAgents Control Installer
|
||||||
# Interactive installer for OpenCode agents, commands, tools, and plugins
|
# Interactive installer for OpenCode agents, commands, tools, and plugins
|
||||||
#
|
#
|
||||||
# Compatible with:
|
# Compatible with:
|
||||||
|
|
@ -44,9 +44,9 @@ else
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# Configuration
|
# Configuration
|
||||||
REPO_URL="https://github.com/darrenhinde/OpenAgents"
|
REPO_URL="https://github.com/darrenhinde/OpenAgentsControl"
|
||||||
BRANCH="${OPENCODE_BRANCH:-main}" # Allow override via environment variable
|
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
|
# Registry URL - supports local fallback for development
|
||||||
# Priority: 1) REGISTRY_URL env var, 2) Local registry.json, 3) Remote GitHub
|
# Priority: 1) REGISTRY_URL env var, 2) Local registry.json, 3) Remote GitHub
|
||||||
|
|
@ -90,7 +90,7 @@ print_header() {
|
||||||
echo -e "${CYAN}${BOLD}"
|
echo -e "${CYAN}${BOLD}"
|
||||||
echo "╔════════════════════════════════════════════════════════════════╗"
|
echo "╔════════════════════════════════════════════════════════════════╗"
|
||||||
echo "║ ║"
|
echo "║ ║"
|
||||||
echo "║ OpenAgents Installer v1.0.0 ║"
|
echo "║ OpenAgents Control Installer v1.0.0 ║"
|
||||||
echo "║ ║"
|
echo "║ ║"
|
||||||
echo "╚════════════════════════════════════════════════════════════════╝"
|
echo "╚════════════════════════════════════════════════════════════════╝"
|
||||||
echo -e "${NC}"
|
echo -e "${NC}"
|
||||||
|
|
@ -477,7 +477,7 @@ check_interactive_mode() {
|
||||||
echo "For interactive mode, download the script first:"
|
echo "For interactive mode, download the script first:"
|
||||||
echo ""
|
echo ""
|
||||||
echo -e "${CYAN}# Download the script${NC}"
|
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 ""
|
||||||
echo -e "${CYAN}# Run interactively${NC}"
|
echo -e "${CYAN}# Run interactively${NC}"
|
||||||
echo "bash install.sh"
|
echo "bash install.sh"
|
||||||
|
|
@ -485,7 +485,7 @@ check_interactive_mode() {
|
||||||
echo "Or use a profile directly:"
|
echo "Or use a profile directly:"
|
||||||
echo ""
|
echo ""
|
||||||
echo -e "${CYAN}# Quick install with profile${NC}"
|
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 ""
|
||||||
echo "Available profiles: essential, developer, business, full, advanced"
|
echo "Available profiles: essential, developer, business, full, advanced"
|
||||||
echo ""
|
echo ""
|
||||||
|
|
@ -1369,7 +1369,7 @@ main() {
|
||||||
echo " $0 developer"
|
echo " $0 developer"
|
||||||
echo ""
|
echo ""
|
||||||
echo " ${CYAN}# Install from URL (non-interactive)${NC}"
|
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 ""
|
||||||
echo -e "${BOLD}Platform Support:${NC}"
|
echo -e "${BOLD}Platform Support:${NC}"
|
||||||
echo " ✓ Linux (bash 3.2+)"
|
echo " ✓ Linux (bash 3.2+)"
|
||||||
|
|
|
||||||
|
|
@ -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
|
## 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
|
2. **Local Adapter**: Immediate context-aware behavior when using Claude in this repo
|
||||||
|
|
||||||
## Directory Structure
|
## Directory Structure
|
||||||
|
|
||||||
```
|
```
|
||||||
integrations/claude-code/
|
integrations/claude-code/
|
||||||
├── converter/ # Scripts to convert OpenAgents → Claude format
|
├── converter/ # Scripts to convert OpenAgents Control → Claude format
|
||||||
│ └── src/
|
|
||||||
│ └── convert-agents.js
|
|
||||||
├── generated/ # Output of conversion (gitignored)
|
├── generated/ # Output of conversion (gitignored)
|
||||||
│ ├── agents/
|
|
||||||
│ └── skills/
|
|
||||||
├── plugin/ # Final plugin files for distribution
|
├── plugin/ # Final plugin files for distribution
|
||||||
│ ├── agents/
|
|
||||||
│ ├── skills/
|
|
||||||
│ └── .claude-plugin/
|
|
||||||
│ └── plugin.json
|
|
||||||
├── bootstrap-install.sh # One-line installer (downloads bundle)
|
├── bootstrap-install.sh # One-line installer (downloads bundle)
|
||||||
└── install.sh # Install script for distribution
|
└── install-claude.sh # Install script for distribution
|
||||||
```
|
```
|
||||||
|
|
||||||
## Quick Start
|
## Quick Start
|
||||||
|
|
@ -35,14 +27,14 @@ integrations/claude-code/
|
||||||
Just run Claude in this repository:
|
Just run Claude in this repository:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd /path/to/opencode-agents
|
cd OpenAgentsControl
|
||||||
claude
|
claude
|
||||||
```
|
```
|
||||||
|
|
||||||
Claude will automatically:
|
Claude will automatically:
|
||||||
- Load the `openagents-standards` Skill
|
- Load the `openagents-control-standards` Skill
|
||||||
- Use `context-scout` to find relevant context in `.opencode/context/`
|
- Use `context-scout` to find relevant context in `.opencode/context/`
|
||||||
- Apply OpenAgents standards to any task
|
- Apply OpenAgents Control standards to any task
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary><strong>⚠️ Claude CLI Workaround</strong></summary>
|
<summary><strong>⚠️ Claude CLI Workaround</strong></summary>
|
||||||
|
|
@ -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/`
|
1. **Restart Claude Code** after any changes to `.claude/`
|
||||||
2. **Explicitly reference the context** in your request:
|
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:
|
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.
|
This will activate the context loading workflow.
|
||||||
|
|
||||||
**Known Issue**: Skills auto-trigger based on Claude's heuristic. If it doesn't trigger:
|
**Known Issue**: Skills auto-trigger based on Claude's heuristic. If it doesn't trigger:
|
||||||
- The `context-scout` subagent will still be available
|
- The `context-scout` subagent will still be available
|
||||||
- You can call it manually: `task(subagent_type="context-scout", ...)`
|
- 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
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
||||||
### Install Claude CLI (if needed)
|
### Install Claude CLI (if needed)
|
||||||
|
|
||||||
**macOS**:
|
**macOS**:
|
||||||
|
|
@ -89,7 +82,7 @@ claude --version
|
||||||
### One-Line Install (Recommended)
|
### One-Line Install (Recommended)
|
||||||
|
|
||||||
```bash
|
```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`
|
**Prereqs**: `git`, `bash`
|
||||||
|
|
@ -114,22 +107,22 @@ This generates Claude-ready files in `integrations/claude-code/generated/`.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd integrations/claude-code
|
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
|
### Step 3: Use with Claude Code
|
||||||
|
|
||||||
**With plugin (recommended for distributed use)**:
|
**With plugin (recommended for distributed use)**:
|
||||||
```bash
|
```bash
|
||||||
claude --plugin-dir ~/.claude/plugins/openagents-bridge
|
claude --plugin-dir ~/.claude/plugins/openagents-control-bridge
|
||||||
```
|
```
|
||||||
|
|
||||||
**Without plugin (manual mode)**:
|
**Without plugin (manual mode)**:
|
||||||
```bash
|
```bash
|
||||||
# Set environment variable to load context files
|
# 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
|
# Run Claude with context loaded from your prompt
|
||||||
claude
|
claude
|
||||||
|
|
@ -149,15 +142,15 @@ claude
|
||||||
|
|
||||||
### Context Discovery
|
### 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/`.
|
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
|
### 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` |
|
| `id` | `name` |
|
||||||
| `description` | `description` |
|
| `description` | `description` |
|
||||||
|
|
@ -181,7 +174,7 @@ Add to `.opencode/agent/{category}/{agent}.md`. The local adapter in `.claude/`
|
||||||
|
|
||||||
- `.claude/` - Local adapter (committed)
|
- `.claude/` - Local adapter (committed)
|
||||||
- `integrations/claude-code/converter/src/convert-agents.js` - Converter script (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
|
## Files to GitIgnore
|
||||||
|
|
||||||
|
|
@ -199,7 +192,7 @@ Add to `.opencode/agent/{category}/{agent}.md`. The local adapter in `.claude/`
|
||||||
|---------|-------------|
|
|---------|-------------|
|
||||||
| `claude` | Start interactive session |
|
| `claude` | Start interactive session |
|
||||||
| `claude "request"` | One-shot request |
|
| `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 --print-plugins` | Show loaded plugins |
|
||||||
| `claude --debug` | Debug mode |
|
| `claude --debug` | Debug mode |
|
||||||
| `claude --version` | Show version |
|
| `claude --version` | Show version |
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* convert-agents.js
|
* convert-agents.js
|
||||||
* Converts OpenAgents to Claude Code format
|
* Converts OpenAgents Control to Claude Code format
|
||||||
*
|
*
|
||||||
* Usage: node convert-agents.js [--watch]
|
* 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)
|
// Claude frontmatter fields (subset of OpenCode)
|
||||||
const CLAUDE_FIELDS = ['name', 'description', 'tools', 'model', 'permissionMode', 'skills', 'hooks'];
|
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(` Source: ${SOURCE_DIR}`);
|
||||||
console.log(` Output: ${OUTPUT_DIR}\n`);
|
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 });
|
if (fs.existsSync(CLAUDE_SKILLS_DIR)) fs.rmSync(CLAUDE_SKILLS_DIR, { recursive: true });
|
||||||
|
|
||||||
fs.mkdirSync(CLAUDE_AGENTS_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');
|
console.log('📦 Converting agents...\n');
|
||||||
|
|
||||||
|
|
@ -183,7 +183,7 @@ function convert() {
|
||||||
// Create default context-scout subagent
|
// Create default context-scout subagent
|
||||||
const contextScoutContent = `---
|
const contextScoutContent = `---
|
||||||
name: context-scout
|
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
|
tools: Read, Grep, Glob
|
||||||
model: haiku
|
model: haiku
|
||||||
permissionMode: plan
|
permissionMode: plan
|
||||||
|
|
@ -191,7 +191,7 @@ permissionMode: plan
|
||||||
|
|
||||||
# ContextScout
|
# 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
|
## Your Process
|
||||||
|
|
||||||
|
|
@ -205,23 +205,23 @@ You discover and recommend relevant OpenAgents context files from \`.opencode/co
|
||||||
contextScoutContent
|
contextScoutContent
|
||||||
);
|
);
|
||||||
|
|
||||||
// Create openagents-standards skill
|
// Create openagents-control-standards skill
|
||||||
const skillContent = `---
|
const skillContent = `---
|
||||||
name: openagents-standards
|
name: openagents-control-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.
|
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:
|
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.
|
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(
|
fs.writeFileSync(
|
||||||
path.join(CLAUDE_SKILLS_DIR, 'openagents-standards/SKILL.md'),
|
path.join(CLAUDE_SKILLS_DIR, 'openagents-control-standards/SKILL.md'),
|
||||||
skillContent
|
skillContent
|
||||||
);
|
);
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
#!/usr/bin/env bash
|
#!/usr/bin/env bash
|
||||||
#
|
#
|
||||||
# install-claude.sh
|
# install-claude.sh
|
||||||
# Installs OpenAgents to Claude Code with automatic conversion
|
# Installs OpenAgents Control to Claude Code with automatic conversion
|
||||||
#
|
#
|
||||||
|
|
||||||
set -euo pipefail
|
set -euo pipefail
|
||||||
|
|
@ -17,10 +17,10 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
|
REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
|
||||||
OPENCODE_DIR="$REPO_ROOT/.opencode/agent"
|
OPENCODE_DIR="$REPO_ROOT/.opencode/agent"
|
||||||
CONVERTER_DIR="$SCRIPT_DIR/converter"
|
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}"
|
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 " Source: $OPENCODE_DIR"
|
||||||
echo -e " Destination: $PLUGIN_DEST"
|
echo -e " Destination: $PLUGIN_DEST"
|
||||||
echo ""
|
echo ""
|
||||||
|
|
@ -93,7 +93,7 @@ verify() {
|
||||||
echo " claude --plugin-dir $PLUGIN_DEST"
|
echo " claude --plugin-dir $PLUGIN_DEST"
|
||||||
echo ""
|
echo ""
|
||||||
echo "Or add to your Claude Code settings for automatic loading:"
|
echo "Or add to your Claude Code settings for automatic loading:"
|
||||||
echo ' { "plugins": ["openagents-bridge"] }'
|
echo ' { "plugins": ["openagents-control-bridge"] }'
|
||||||
echo ""
|
echo ""
|
||||||
echo "Verify Claude Code installation:"
|
echo "Verify Claude Code installation:"
|
||||||
echo " claude --version"
|
echo " claude --version"
|
||||||
|
|
|
||||||
|
|
@ -61,6 +61,6 @@
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
"url": "https://github.com/darrenhinde/OpenAgents.git"
|
"url": "https://github.com/darrenhinde/OpenAgentsControl.git"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -109,7 +109,7 @@ Runs a shell command deterministically.
|
||||||
|
|
||||||
### Agent
|
### Agent
|
||||||
|
|
||||||
Calls an OpenAgents agent.
|
Calls an OpenAgents Control agent.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
- id: review
|
- id: review
|
||||||
|
|
|
||||||
|
|
@ -37,7 +37,7 @@
|
||||||
"workflows",
|
"workflows",
|
||||||
"agents"
|
"agents"
|
||||||
],
|
],
|
||||||
"author": "OpenAgents",
|
"author": "OpenAgents Control",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@opencode-ai/plugin": "^1.0.223",
|
"@opencode-ai/plugin": "^1.0.223",
|
||||||
|
|
|
||||||
|
|
@ -53,7 +53,7 @@ async function main() {
|
||||||
console.log('\n🚀 Testing ability.run tool...\n')
|
console.log('\n🚀 Testing ability.run tool...\n')
|
||||||
const runResult = await tools['ability.run'].execute({
|
const runResult = await tools['ability.run'].execute({
|
||||||
name: 'hello-world',
|
name: 'hello-world',
|
||||||
inputs: { name: 'OpenAgents' }
|
inputs: { name: 'OpenAgents Control' }
|
||||||
})
|
})
|
||||||
console.log(JSON.stringify(runResult, null, 2))
|
console.log(JSON.stringify(runResult, null, 2))
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
{
|
{
|
||||||
"version": "2.0.0",
|
"version": "2.0.0",
|
||||||
"schema_version": "2.0.0",
|
"schema_version": "2.0.0",
|
||||||
"repository": "https://github.com/darrenhinde/OpenAgents",
|
"repository": "https://github.com/darrenhinde/OpenAgentsControl",
|
||||||
"categories": {
|
"categories": {
|
||||||
"essential": "Minimal components for basic functionality",
|
"essential": "Minimal components for basic functionality",
|
||||||
"standard": "Standard components for typical use",
|
"standard": "Standard components for typical use",
|
||||||
|
|
@ -172,7 +172,7 @@
|
||||||
"name": "OpenRepoManager",
|
"name": "OpenRepoManager",
|
||||||
"type": "agent",
|
"type": "agent",
|
||||||
"path": ".opencode/agent/meta/repo-manager.md",
|
"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": [],
|
"tags": [],
|
||||||
"dependencies": [],
|
"dependencies": [],
|
||||||
"category": "meta"
|
"category": "meta"
|
||||||
|
|
@ -570,7 +570,7 @@
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"id": "commit-openagents",
|
"id": "commit-openagents",
|
||||||
"name": "Commit Openagents",
|
"name": "Commit OpenAgents Control",
|
||||||
"type": "command",
|
"type": "command",
|
||||||
"path": ".opencode/command/commit-openagents.md",
|
"path": ".opencode/command/commit-openagents.md",
|
||||||
"description": "description: Smart commit command for opencode-agents repository with automatic validation and conventional commits",
|
"description": "description: Smart commit command for opencode-agents repository with automatic validation and conventional commits",
|
||||||
|
|
@ -1010,7 +1010,7 @@
|
||||||
"name": "Quick Start",
|
"name": "Quick Start",
|
||||||
"type": "context",
|
"type": "context",
|
||||||
"path": ".opencode/context/openagents-repo/quick-start.md",
|
"path": ".opencode/context/openagents-repo/quick-start.md",
|
||||||
"description": "OpenAgents Repository - Quick Start",
|
"description": "OpenAgents Control Repository - Quick Start",
|
||||||
"tags": [],
|
"tags": [],
|
||||||
"dependencies": [],
|
"dependencies": [],
|
||||||
"category": "standard"
|
"category": "standard"
|
||||||
|
|
@ -1915,7 +1915,7 @@
|
||||||
"name": "Navigation",
|
"name": "Navigation",
|
||||||
"type": "context",
|
"type": "context",
|
||||||
"path": ".opencode/context/openagents-repo/navigation.md",
|
"path": ".opencode/context/openagents-repo/navigation.md",
|
||||||
"description": "OpenAgents Repository Context",
|
"description": "OpenAgents Control Repository Context",
|
||||||
"tags": [],
|
"tags": [],
|
||||||
"dependencies": [],
|
"dependencies": [],
|
||||||
"category": "standard"
|
"category": "standard"
|
||||||
|
|
@ -2273,7 +2273,7 @@
|
||||||
"name": "Building Cli Compact",
|
"name": "Building Cli Compact",
|
||||||
"type": "context",
|
"type": "context",
|
||||||
"path": ".opencode/context/openagents-repo/guides/building-cli-compact.md",
|
"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": [],
|
"tags": [],
|
||||||
"dependencies": [],
|
"dependencies": [],
|
||||||
"category": "standard"
|
"category": "standard"
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Scripts
|
# 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
|
## Directory Structure
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -27,7 +27,7 @@ bash scripts/tests/test-compatibility.sh
|
||||||
|
|
||||||
**Run remotely:**
|
**Run remotely:**
|
||||||
```bash
|
```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:**
|
**What it tests:**
|
||||||
|
|
|
||||||
|
|
@ -162,7 +162,7 @@ fi
|
||||||
# Test 12: Network connectivity
|
# Test 12: Network connectivity
|
||||||
echo ""
|
echo ""
|
||||||
echo "Test 12: Network Connectivity"
|
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"
|
pass "Network connectivity to GitHub works"
|
||||||
else
|
else
|
||||||
warn "Network connectivity test failed (may be offline)"
|
warn "Network connectivity test failed (may be offline)"
|
||||||
|
|
@ -175,5 +175,5 @@ echo "╚═══════════════════════
|
||||||
echo ""
|
echo ""
|
||||||
echo "Your system is compatible with the OpenCode installer."
|
echo "Your system is compatible with the OpenCode installer."
|
||||||
echo "You can safely run:"
|
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 ""
|
echo ""
|
||||||
|
|
|
||||||
|
|
@ -4,7 +4,7 @@
|
||||||
# Non-Interactive Mode Test Script
|
# Non-Interactive Mode Test Script
|
||||||
# Tests the installer behavior when run via pipe (curl | bash)
|
# 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.
|
# where interactive prompts fail silently in piped execution.
|
||||||
#############################################################################
|
#############################################################################
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
#!/usr/bin/env bash
|
#!/usr/bin/env bash
|
||||||
|
|
||||||
#############################################################################
|
#############################################################################
|
||||||
# OpenAgents Updater
|
# OpenAgents Control Updater
|
||||||
# Updates existing OpenCode components to latest versions
|
# Updates existing OpenCode components to latest versions
|
||||||
#############################################################################
|
#############################################################################
|
||||||
|
|
||||||
|
|
@ -15,7 +15,7 @@ CYAN='\033[0;36m'
|
||||||
BOLD='\033[1m'
|
BOLD='\033[1m'
|
||||||
NC='\033[0m'
|
NC='\033[0m'
|
||||||
|
|
||||||
REPO_URL="https://raw.githubusercontent.com/darrenhinde/OpenAgents/main"
|
REPO_URL="https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main"
|
||||||
INSTALL_DIR=".opencode"
|
INSTALL_DIR=".opencode"
|
||||||
|
|
||||||
print_success() { echo -e "${GREEN}✓${NC} $1"; }
|
print_success() { echo -e "${GREEN}✓${NC} $1"; }
|
||||||
|
|
@ -26,7 +26,7 @@ print_header() {
|
||||||
echo -e "${CYAN}${BOLD}"
|
echo -e "${CYAN}${BOLD}"
|
||||||
echo "╔════════════════════════════════════════════════════════════════╗"
|
echo "╔════════════════════════════════════════════════════════════════╗"
|
||||||
echo "║ ║"
|
echo "║ ║"
|
||||||
echo "║ OpenAgents Updater v1.0.0 ║"
|
echo "║ OpenAgents Control Updater v1.0.0 ║"
|
||||||
echo "║ ║"
|
echo "║ ║"
|
||||||
echo "╚════════════════════════════════════════════════════════════════╝"
|
echo "╚════════════════════════════════════════════════════════════════╝"
|
||||||
echo -e "${NC}"
|
echo -e "${NC}"
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue