Minimal Harness Agent

@zack/harness-minimal-agent

Minimal AgentPM Harness starter that installs one published Agent package and runs it through the reference Harness TUI or headless CLI.

Use case: harness-startagentpm-runworkspaceshell
Bootstrap
agentpm new @zack/harness-minimal-agent@0.1.0 my-project
Next steps
cp .env.local.example .env.local
Weekly starts
1
0%
Last publish
Today
v0.1.0
agent.json
{
  "name": "harness-minimal-agent",
  "version": "0.1.0",
  "description": "Minimal AgentPM Harness starter that installs one published Agent package and runs it through the reference Harness TUI or headless CLI.",
  "template": {
    "display_name": "Minimal Harness Agent",
    "use_case": "harness-start",
    "execution_surfaces": [
      "agentpm-run"
    ],
    "stack": [
      "workspace",
      "shell"
    ],
    "files_root": "template",
    "variables": [
      {
        "name": "project_name",
        "default": "harness-minimal-agent",
        "required": true,
        "description": "Generated project name. Generation-time only; do not use for API keys, tokens, passwords, or runtime secrets."
      },
      {
        "name": "workspace_label",
        "default": "Minimal Harness Agent",
        "required": true,
        "description": "Human-readable label shown in the generated README and Harness TUI header."
      },
      {
        "name": "default_user_scope",
        "default": "local-maintainer",
        "required": true,
        "description": "Default local user scope value used by the sample Harness config."
      },
      {
        "name": "default_repository_scope",
        "default": "agentpm-dev/agentpm-examples",
        "required": true,
        "description": "Default local repository scope value used by the sample Harness config."
      },
      {
        "name": "openai_model",
        "default": "gpt-4o-mini",
        "required": true,
        "description": "Default OpenAI model identifier used by agentpm.harness.json. Set credentials at runtime, not as a template variable."
      },
      {
        "name": "ollama_model",
        "default": "llama3.1",
        "required": true,
        "description": "Default local Ollama model identifier used by agentpm.ollama.harness.json."
      }
    ],
    "dependencies": {
      "tools": [],
      "agents": [
        {
          "name": "@zack/devwork-copilot",
          "version": "0.1.6"
        }
      ]
    },
    "entrypoints": [
      {
        "label": "Create local env file",
        "command": "cp .env.local.example .env.local"
      },
      {
        "label": "Export local env for this shell",
        "command": "set -a; source .env.local; set +a"
      },
      {
        "label": "Check Harness readiness",
        "command": "agentpm harness --json"
      },
      {
        "label": "Open the Harness TUI",
        "command": "agentpm harness"
      },
      {
        "label": "Run one headless prompt",
        "command": "agentpm harness --headless --input \"Review this generated workspace and summarize what the installed Agent can do.\" --report reports/first-run.json"
      }
    ]
  },
  "readme": "README.md",
  "license": {
    "spdx": "MIT"
  }
}
Template metadata
Use case
harness-start
Execution surfaces
agentpm-run
Stack
workspaceshell
Included packages
Tools
This template does not declare any tool package dependencies.
Skills
This template does not declare any skill package dependencies.
Knowledge
This template does not declare any knowledge package dependencies.
Memory
This template does not declare any memory package dependencies.
Profiles
This template does not declare any profile package dependencies.
Loop
This template does not declare any loop package dependency.
Entrypoints
Create local env file
cp .env.local.example .env.local
Export local env for this shell
set -a; source .env.local; set +a
Check Harness readiness
agentpm harness --json
Open the Harness TUI
agentpm harness
Run one headless prompt
agentpm harness --headless --input "Review this generated workspace and summarize what the installed Agent can do." --report reports/first-run.json