OpenWriterControle/scripts
darrenhinde d7e1aa7f19 feat: add monorepo structure with versioning and CI/CD
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
2025-11-26 22:06:36 +00:00
..
tests refactor: simplify agent execution philosophy and reorganize context structure 2025-11-19 13:13:06 +00:00
bump-version.sh feat: add monorepo structure with versioning and CI/CD 2025-11-26 22:06:36 +00:00
cleanup-stale-sessions.sh ✨ feat: introduce OpenAgent universal agent with session management 2025-11-18 18:45:42 +00:00
dashboard.sh feat: add monorepo structure with versioning and CI/CD 2025-11-26 22:06:36 +00:00
README.md Rename to OpenAgents, remove model specs, and update documentation 2025-11-18 22:37:41 +00:00
register-component.sh fix: simplify registration script to preserve manual registry 2025-11-17 23:43:13 +00:00
test.sh feat: add monorepo structure with versioning and CI/CD 2025-11-26 22:06:36 +00:00
uninstall.sh feat: enhance installation system with universal path transformation 2025-11-19 11:22:48 +00:00
validate-component.sh feat: add interactive installer with component registry system 2025-11-17 23:43:13 +00:00
validate-context-refs.sh feat: enhance installation system with universal path transformation 2025-11-19 11:22:48 +00:00

Scripts

This directory contains utility scripts for the OpenAgents 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:

# 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