What you can do with Agnes Harness

5 use cases

• Add a business tool to the agent as a plugin

  Register a customer-specific tool as a backend plugin so the agent can call it.

  • Agnes Harness
  • Software and DevOps
  • Intermediate
  View prompt

  Work in the agnes-harness repository at <repo path>. Follow docs/develop/backend.md to add a backend plugin that exposes a tool named <tool name> for <business system>. Confirm the tool appears in a task and returns structured output. Report the files you changed.

  Share Save

• Review a codebase with approvals and a visible trace

  Ask the agent to explain a project read-only and check each step in the Trace view.

  • Agnes Harness
  • Software and DevOps
  • Intermediate
  View prompt

  In the agnes-harness repository at <repo path>, start AGH with `node packages/cli/dist/local/agnes.mjs serve`, then ask it to explain <target project> without modifying files. Expected output: a summary of the project's purpose and directory layout, plus a Trace of every tool call and approval. Verify that no files changed in the target directory.

  Share Save

• Continue a Web task from the terminal

  Resume a session started in the browser and keep working in the CLI with the same history.

  • Agnes Harness
  • Software and DevOps
  • Intermediate
  View prompt

  Using the agnes-harness repository at <repo path>, start the AGH server, create a task in the Web interface, then resume that session from the CLI with /resume. Expected output: the terminal shows the earlier history and the new message appears in the Web thread. Verify both views show the same session ID.

  Share Save

• Run the Mars rescue demo with virtual devices

  Coordinate a simulated hopper, robot, and airlock through MHS without any hardware.

  • Agnes Harness
  • Software and DevOps
  • Advanced
  View prompt

  In the agnes-harness repository at <repo path>, follow docs/guide/mars-world.md to start the eleven virtual devices and the @agnes/mhs plugin. Ask the agent to send the hopper to find the astronaut and coordinate the robot and airlock. Expected output: device state reads, action requests, and returned camera observations in the Trace. Verify that Mars World reflects each action.

  Share Save

• Package a backend service with its own workbench panel

  Build a full-stack plugin that pairs a business service with a role-specific Web panel.

  • Agnes Harness
  • Software and DevOps
  • Advanced
  View prompt

  In the agnes-harness repository at <repo path>, follow docs/develop/fullstack.md to build a full-stack plugin that shows <business data> in a sidebar panel for <role>. Expected output: the panel loads and displays the backend result, and an update followed by a rollback restores the earlier version. Verify the installed plugin's version, source, and hashes before enabling it.

  Share Save

How to use Agnes Harness

1. Check you have what it needs: Node.js 24.10 or newer; pnpm 10.34.5; Native build tools for your platform.
2. Open AgnesAI-Labs/agnes-harness on GitHub and read the README and license.
3. Clone the Agnes Harness repository and open its root directory.
4. Run pnpm install --frozen-lockfile.
5. Run pnpm --filter @agnes/cli build:local.
6. Read the backend plugin guide at docs/develop/backend.md and start from the demo_text_stats example.

These steps come from our top use case, Add a business tool to the agent as a plugin, which also has a copy-paste agent prompt.

Agnes Harness alternatives · Best AI repos for Software and DevOps

About this repo

• Who it is forDevelopers and forward deployed engineers who can build a TypeScript monorepo from source and want to extend an agent with business tools, panels, or device integrations.
• Why it is hot
• LanguageTypeScript
• Sourcegithub.com/AgnesAI-Labs/agnes-harness · Back to Hot repos

Requirements

• Node.js 24.10 or newer
• pnpm 10.34.5
• Native build tools for your platform
• A cloned copy of the agnes-harness source repository
• A configured AI model in the Web interface

Related repos

• Trended earlier Omarchy Local AI Local AI is an Omarchy plugin that runs a validated local model on your own GPU or CPU in Docker and opens coding agents on it.
• Trended earlier Hermes Plan Mode A plugin for Hermes Agent that enforces a Claude Code-style plan mode: the agent explores read-only, writes a plan file, and makes changes only after you approve the plan.
• Trended earlier Agent 2 Agent-2 is a Python agent harness that runs on your machine with your own Gemini API keys and can write code, run terminal commands, manage files, and coordinate tools.