Monorepo Features: - Root package.json with convenient npm scripts for all agents - Easy testing from root: npm test, npm run test:openagent, npm run test:opencoder - Multi-model support: test with Grok, Claude, or GPT-4 - Quick dashboard access: npm run dashboard - No folder navigation required Versioning System: - VERSION file tracking current version (0.1.0-alpha.1) - CHANGELOG.md with comprehensive version history - Version bump scripts for alpha, beta, rc, and stable releases - Semantic versioning with progression: Alpha → Beta → RC → Stable CI/CD: - GitHub Actions workflow for automated testing - Pre-merge validation for agent changes - Smoke tests for both openagent and opencoder - Automated test result reporting - Runs on PRs to main/dev and pushes to main Helper Scripts: - scripts/test.sh: Advanced test runner with multi-agent support - scripts/dashboard.sh: Enhanced dashboard launcher with auto-open - scripts/bump-version.sh: Version management tool Documentation: - QUICK_START.md: Comprehensive testing and usage guide - Clear examples for all test scenarios - Multi-agent and multi-model workflows Benefits: - Easy testing from root directory - Automated quality checks before merges - Clear version tracking and history - Developer-friendly workflows - No breaking changes to existing structure |
||
|---|---|---|
| .. | ||
| tests | ||
| bump-version.sh | ||
| cleanup-stale-sessions.sh | ||
| dashboard.sh | ||
| README.md | ||
| register-component.sh | ||
| test.sh | ||
| uninstall.sh | ||
| validate-component.sh | ||
| validate-context-refs.sh | ||
Scripts
This directory contains utility scripts for the OpenAgents system.
Available Scripts
Component Management
register-component.sh- Register a new component in the registryvalidate-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:
# 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
./scripts/register-component.sh path/to/component
Validate a Component
./scripts/validate-component.sh path/to/component
Clean Stale Sessions
./scripts/cleanup-stale-sessions.sh