Major architectural refactoring: - Add OpenAgent as universal primary agent for questions, tasks, and workflows - Implement session-based context management with manifest tracking - Reorganize subagents into logical categories (code/core/utils) - Add dynamic context discovery and loading system - Introduce cleanup script for stale sessions - Update registry with new categorization (essential/standard/extended/specialized/meta) - Rename 'core' profile to 'essential' and add 'business' profile - Add comprehensive documentation with visual diagrams - Update installation script with new profiles Breaking changes: - Subagent paths changed from analysis/core to code/core/utils - Profile 'core' renamed to 'essential' (backward compatible) New features: - Session isolation for concurrent agent instances (.tmp/sessions/) - Automatic stale session cleanup (>24 hours) - Manifest-based context indexing and discovery - Business profile for content-focused workflows - OpenAgent with plan-approve-execute-validate-summarize workflow Components: 32 total (3 agents, 13 subagents, 8 commands, 2 tools, 2 plugins, 2 contexts, 2 config) Documentation: - docs/agents/openagent.md - Comprehensive guide with Mermaid diagrams - docs/guides/building-with-opencode.md - Power user formula - scripts/README.md - Script documentation - .opencode/context/core/context-management.md - Session management strategy
49 lines
1.1 KiB
Markdown
49 lines
1.1 KiB
Markdown
# Scripts
|
|
|
|
This directory contains utility scripts for the OpenCode Agents system.
|
|
|
|
## Available Scripts
|
|
|
|
### Component Management
|
|
|
|
- `register-component.sh` - Register a new component in the registry
|
|
- `validate-component.sh` - Validate component structure and metadata
|
|
|
|
### Session Management
|
|
|
|
- `cleanup-stale-sessions.sh` - Remove stale agent sessions older than 24 hours
|
|
|
|
### Testing
|
|
|
|
See `tests/` subdirectory for test scripts.
|
|
|
|
## Session Cleanup
|
|
|
|
Agent instances create temporary context files in `.tmp/sessions/{session-id}/` for subagent delegation. These sessions are automatically cleaned up, but you can manually remove stale sessions:
|
|
|
|
```bash
|
|
# Clean up sessions older than 24 hours
|
|
./scripts/cleanup-stale-sessions.sh
|
|
|
|
# Or manually delete all sessions
|
|
rm -rf .tmp/sessions/
|
|
```
|
|
|
|
Sessions are safe to delete anytime - they only contain temporary context files for agent coordination.
|
|
|
|
## Usage Examples
|
|
|
|
### Register a Component
|
|
```bash
|
|
./scripts/register-component.sh path/to/component
|
|
```
|
|
|
|
### Validate a Component
|
|
```bash
|
|
./scripts/validate-component.sh path/to/component
|
|
```
|
|
|
|
### Clean Stale Sessions
|
|
```bash
|
|
./scripts/cleanup-stale-sessions.sh
|
|
```
|