History

darrenhinde 2bc97007c1 refactor: simplify agent execution philosophy and reorganize context structure Major Changes: - Simplified OpenAgent execution philosophy (universal agent, delegate sparingly) - Reorganized context into 3-tier structure: standards/, workflows/, system/ - Improved approval gate wording for clarity - Enhanced .gitignore with comprehensive Node.js patterns - Added comprehensive plugin development guide Context Reorganization: - Consolidated scattered files into organized structure with Quick Reference sections - Emphasis on lazy loading for token efficiency (60-80% token savings) - New standards: code.md, docs.md, tests.md, patterns.md, analysis.md - New workflows: delegation.md, sessions.md, task-breakdown.md, review.md - New system: context-guide.md (master reference) Delegation Improvements: - Removed complex XML-style routing rules - Simplified to clear when/how structure with 7 delegation criteria - Added Perspective and Simulation as delegation triggers - Clearer delegation template and process Documentation Enhancements: - Added building-plugins.md (1,274 lines - comprehensive plugin guide) - Updated how-context-works.md with research-backed architecture - Enhanced slash-commands-and-subagents.md with path resolution findings Content Preservation: - context-discovery.md → system/context-guide.md + workflows/sessions.md - context-management.md → workflows/sessions.md - essential-patterns.md → standards/patterns.md - session-management.md → workflows/sessions.md		2025-11-19 13:13:06 +00:00
..
tests	refactor: simplify agent execution philosophy and reorganize context structure	2025-11-19 13:13:06 +00:00
cleanup-stale-sessions.sh	✨ feat: introduce OpenAgent universal agent with session management	2025-11-18 18:45:42 +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
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

README.md

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