openagent

Self-hosted orchestrator for AI autonomous agents. Run Claude Code & Open Code in isolated Linux workspaces. Manage skills, configs, and encrypted secrets with a git repo. Ideal for developers and operations teams.

[{"step":"Install OpenAgent and initialize a new agent workspace","action":"Run `openagent init --name DataPipelineProcessor --workspace /path/to/workspace` in your terminal. This creates a git-managed directory with default configurations and encrypted secret storage.","tip":"Use `--template dev` for development environments or `--template prod` for production workloads with stricter resource limits."},{"step":"Configure skills and secrets","action":"Edit the `skills.yaml` file to specify which skills to load (e.g., file_operations, data_validation). Store secrets in `secrets.env` and encrypt them with `openagent encrypt --file secrets.env --key your-encryption-key`.","tip":"Commit the encrypted secrets file to git but never commit the encryption key. Use environment variables for the key in CI/CD pipelines."},{"step":"Define the agent's task and run it","action":"Create a task file (e.g., `tasks/process_sales_data.yaml`) with your instructions. Execute with `openagent run --task tasks/process_sales_data.yaml --workspace /path/to/workspace`.","tip":"Use the `--dry-run` flag to preview the agent's plan before execution. Add `--log-level debug` for detailed output during troubleshooting."},{"step":"Monitor and review results","action":"Check the workspace directory for output files and logs. Use `openagent logs --workspace /path/to/workspace` to stream real-time logs. Verify results against your success criteria.","tip":"Set up a cron job or CI/CD trigger to run the agent periodically (e.g., daily at 2 AM). Use `openagent status` to check agent health and resource usage."},{"step":"Update and iterate","action":"Modify the task or skills configuration based on results. Commit changes to git for version control. Use `openagent update --workspace /path/to/workspace` to pull the latest skill versions.","tip":"Create a `CHANGELOG.md` in your workspace to track agent updates and their impact on tasks."}]