OpenHarness
"OpenHarness: Open Agent Harness with a Built-in Personal Agent--Ohmo!"
File Explorer
Download Latest Version (.zip)- skills
- feature-matrix.md
- test-patterns.md
- SKILL.md
- merge-scenarios.md
- SKILL.md
- bug_report.yml
- config.yml
- feature_request.yml
- autopilot-pages.yml
- autopilot-run-next.yml
- autopilot-scan.yml
- ci.yml
- PULL_REQUEST_TEMPLATE.md
- architecture-comic.png
- cli-typing.gif
- harness-equation.png
- landing.png
- logo.png
- ohmo.png
- scene-agentloop.png
- scene-context.png
- scene-governance.png
- scene-swarm.png
- scene-toolkit.png
- snapshot.json
- HeroBackground.tsx
- PipelineAnimation.tsx
- App.tsx
- index.css
- main.tsx
- types.ts
- vite-env.d.ts
- .gitignore
- index.html
- package-lock.json
- package.json
- tsconfig.app.json
- tsconfig.json
- vite.config.ts
- index-CENkxP5l.css
- index-gQnrxco6.js
- .nojekyll
- index.html
- snapshot.json
- SHOWCASE.md
- CommandPicker.tsx
- Composer.tsx
- ConversationView.tsx
- Footer.tsx
- MarkdownText.test.tsx
- MarkdownText.tsx
- ModalHost.test.tsx
- ModalHost.tsx
- PromptInput.test.ts
- PromptInput.test.tsx
- PromptInput.tsx
- SelectModal.tsx
- SidePanel.tsx
- Spinner.tsx
- StatusBar.tsx
- SwarmPanel.tsx
- TodoPanel.tsx
- ToolCallDisplay.tsx
- TranscriptPane.tsx
- WelcomeBanner.tsx
- useBackendSession.ts
- builtinThemes.ts
- ThemeContext.tsx
- App.tsx
- clipboardImage.ts
- index.tsx
- types.ts
- package-lock.json
- package.json
- tsconfig.json
- __init__.py
- bridge.py
- config.py
- group_tool.py
- models.py
- notify.py
- provider_commands.py
- router.py
- runtime.py
- service.py
- __init__.py
- __main__.py
- cli.py
- group_registry.py
- memory.py
- prompts.py
- runtime.py
- session_storage.py
- workspace.py
- e2e_smoke.py
- install.ps1
- install.sh
- install_dev.sh
- local_system_scenarios.py
- migrate_memory.py
- react_tui_e2e.py
- sync_nanobot_channels.sh
- test_cli_flags.py
- test_docker_sandbox_e2e.py
- test_harness_features.py
- test_headless_rendering.py
- test_react_tui_redesign.py
- test_real_skills_plugins.py
- test_tui_interactions.py
- __init__.py
- client.py
- codex_client.py
- copilot_auth.py
- copilot_client.py
- errors.py
- openai_client.py
- provider.py
- registry.py
- usage.py
- __init__.py
- external.py
- flows.py
- manager.py
- storage.py
- __init__.py
- service.py
- types.py
- __init__.py
- manager.py
- session_runner.py
- types.py
- work_secret.py
- __init__.py
- events.py
- queue.py
- __init__.py
- base.py
- dingtalk.py
- discord.py
- email.py
- feishu.py
- manager.py
- matrix.py
- mochat.py
- qq.py
- slack.py
- telegram.py
- whatsapp.py
- __init__.py
- adapter.py
- UPSTREAM
- __init__.py
- registry.py
- __init__.py
- paths.py
- schema.py
- settings.py
- __init__.py
- agent_definitions.py
- coordinator_mode.py
- __init__.py
- cost_tracker.py
- messages.py
- query.py
- query_engine.py
- stream_events.py
- __init__.py
- events.py
- executor.py
- hot_reload.py
- loader.py
- schemas.py
- types.py
- __init__.py
- default_bindings.py
- loader.py
- parser.py
- resolver.py
- __init__.py
- client.py
- config.py
- types.py
- __init__.py
- agent.py
- manager.py
- memdir.py
- migrate.py
- paths.py
- relevance.py
- scan.py
- schema.py
- search.py
- team.py
- types.py
- usage.py
- __init__.py
- loader.py
- __init__.py
- checker.py
- modes.py
- __init__.py
- extractor.py
- rules.py
- session_hook.py
- __init__.py
- __init__.py
- installer.py
- loader.py
- schemas.py
- types.py
- __init__.py
- claudemd.py
- context.py
- environment.py
- system_prompt.py
- __init__.py
- adapter.py
- docker_backend.py
- docker_image.py
- Dockerfile
- path_validator.py
- session.py
- __init__.py
- backup.py
- lock.py
- prompt.py
- service.py
- __init__.py
- __init__.py
- __init__.py
- __init__.py
- __init__.py
- __init__.py
- cron.py
- cron_scheduler.py
- session_backend.py
- session_storage.py
- token_estimation.py
- tool_outputs.py
- commit.md
- debug.md
- diagnose.md
- plan.md
- review.md
- simplify.md
- skill-creator.md
- test.md
- __init__.py
- __init__.py
- _frontmatter.py
- loader.py
- registry.py
- types.py
- __init__.py
- app_state.py
- store.py
- __init__.py
- in_process.py
- lockfile.py
- mailbox.py
- permission_sync.py
- registry.py
- spawn_utils.py
- subprocess_backend.py
- team_lifecycle.py
- types.py
- worktree.py
- __init__.py
- local_agent_task.py
- local_shell_task.py
- manager.py
- stop_task.py
- types.py
- __init__.py
- builtin.py
- loader.py
- schema.py
- __init__.py
- agent_tool.py
- ask_user_question_tool.py
- base.py
- bash_tool.py
- brief_tool.py
- config_tool.py
- cron_create_tool.py
- cron_delete_tool.py
- cron_list_tool.py
- cron_toggle_tool.py
- enter_plan_mode_tool.py
- enter_worktree_tool.py
- exit_plan_mode_tool.py
- exit_worktree_tool.py
- file_edit_tool.py
- file_read_tool.py
- file_write_tool.py
- glob_tool.py
- grep_tool.py
- image_generation_tool.py
- image_to_text_tool.py
- list_mcp_resources_tool.py
- lsp_tool.py
- mcp_auth_tool.py
- mcp_tool.py
- notebook_edit_tool.py
- read_mcp_resource_tool.py
- remote_trigger_tool.py
- send_message_tool.py
- skill_tool.py
- sleep_tool.py
- task_create_tool.py
- task_get_tool.py
- task_list_tool.py
- task_output_tool.py
- task_stop_tool.py
- task_update_tool.py
- team_create_tool.py
- team_delete_tool.py
- todo_write_tool.py
- tool_search_tool.py
- web_fetch_tool.py
- web_search_tool.py
- __init__.py
- app.py
- backend_host.py
- coordinator_drain.py
- input.py
- output.py
- permission_dialog.py
- protocol.py
- react_launcher.py
- runtime.py
- textual_app.py
- __init__.py
- file_lock.py
- fs.py
- helpers.py
- network_guard.py
- shell.py
- __init__.py
- transitions.py
- __init__.py
- keyterms.py
- stream_stt.py
- voice_mode.py
- __init__.py
- __main__.py
- cli.py
- platforms.py
- __init__.py
- fake_mcp_server.py
- __init__.py
- test_client.py
- test_codex_client.py
- test_copilot_auth.py
- test_copilot_client.py
- test_openai_client.py
- test_external.py
- test_flows.py
- __init__.py
- test_verification.py
- test_core.py
- test_session_flow.py
- test_base.py
- test_feishu_security.py
- test_telegram_security.py
- __init__.py
- test_cli.py
- test_command_flows.py
- test_registry.py
- __init__.py
- test_output_styles_loader.py
- test_paths.py
- test_schema.py
- test_settings.py
- test_agent_definitions.py
- test_coordinator_mode.py
- test_registry.py
- __init__.py
- test_messages.py
- test_query_engine.py
- test_config_cli.py
- test_no_stdlib_types_shadowing.py
- __init__.py
- test_executor.py
- test_priority.py
- test_windows_alias.py
- test_format_strings.py
- __init__.py
- test_client_errors.py
- test_http_flow.py
- test_integration.py
- test_stdio_flow.py
- __init__.py
- test_claude_runtime_memory.py
- test_memdir.py
- test_cli.py
- test_gateway.py
- test_loading.py
- test_ohmo_session_storage.py
- test_prompts.py
- test_workspace.py
- __init__.py
- test_checker.py
- __init__.py
- test_extractor.py
- __init__.py
- test_lifecycle_flow.py
- test_loader.py
- __init__.py
- test_claudemd.py
- test_environment.py
- test_system_prompt.py
- test_adapter.py
- test_docker_backend.py
- test_docker_image.py
- test_path_validator.py
- test_autodream.py
- test_autopilot.py
- test_compact.py
- test_cron.py
- test_cron_scheduler.py
- test_session_storage.py
- test_loader.py
- __init__.py
- test_imports.py
- test_in_process.py
- test_lockfile.py
- test_mailbox.py
- test_permission_sync.py
- test_registry.py
- test_spawn_utils.py
- test_subprocess_backend.py
- test_team_lifecycle.py
- test_types.py
- test_worktree.py
- test_manager.py
- __init__.py
- test_bash_tool.py
- test_core_tools.py
- test_grep_tool.py
- test_image_generation_tool.py
- test_image_to_text_tool.py
- test_integration_flows.py
- test_mcp_auth_tool.py
- test_mcp_tool.py
- test_task_tools.py
- test_web_fetch_tool.py
- __init__.py
- test_coordinator_drain.py
- test_modes.py
- test_project_plugin_security.py
- test_react_backend.py
- test_react_launcher.py
- test_runtime_api_key.py
- test_runtime_close.py
- test_runtime_plan_mode.py
- test_runtime_plugin_tools.py
- test_textual_app.py
- test_tui_exit_sequence.py
- test_fs.py
- test_helpers.py
- test_network_guard.py
- test_shell.py
- __init__.py
- conftest.py
- test_hooks_skills_plugins_real.py
- test_merged_prs_on_autoagent.py
- test_platforms.py
- test_real_large_tasks.py
- test_untested_features.py
- .gitignore
- CHANGELOG.md
- CONTRIBUTING.md
- LICENSE
- pyproject.toml
- README.md
- README.zh-CN.md
- RELEASE_NOTES_v0.1.8.md
- RELEASE_NOTES_v0.1.9.md
๐ Installation Guide
1. Get the code
git clone https://github.com/HKUDS/OpenHarness
Downloads the entire project code from GitHub to your computer.
cd OpenHarness
Moves into the project folder you just downloaded.
2. Official Install Script
Easy RecommendedPrerequisites
- Python 3 Python is required to use pip.
curl -fsSL https://raw.githubusercontent.com/HKUDS/OpenHarness/main/scripts/install.sh | bash
Downloads and runs the official install script in one line โ this handles the full setup automatically.
pip install openharness-ai
Installs the package published on PyPI directly โ no need to clone the source.
After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.
Pulled directly from this repo's README.
3. Docker
EasyPrerequisites
- Git Needed to download the project code from GitHub.
- Docker Desktop Needed to build and run containers. Install it and keep it running in the background.
docker build -f src/openharness/sandbox/Dockerfile -t openharness .
Builds a runnable image based on the Dockerfile.
docker run -p 8080:80 openharness
Runs the built image as an actual container.
Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.
4. Node.js
EasyPrerequisites
cd autopilot-dashboard
This project's files live in a subfolder, so move into it first.
npm install
Downloads and installs the libraries listed in package.json.
npm start
Starts the development/run server.
After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.
5. Python
EasyPrerequisites
pip install openharness-ai
Installs the package published on PyPI directly โ no need to clone the source.
If it runs without errors and prints output in the terminal, it worked.
Pulled directly from this repo's README.
// repository documentation
Was this content helpful?
(0 ratings)