harnessc
v1.0.0-alpha.10
Published
Alpha Harness config CLI for validating, initializing, previewing, and activating AI agent configuration.
Maintainers
Readme
harnessc
Public npm package for the alpha Harness config CLI.
Harness config is a repository-local standard for keeping AI agent prompts,
skills, rules, plugins, and root instruction files in one reviewed .harness
source tree, then projecting them into explicit runtime folders such as
.agents, .claude, .cursor, and .gemini.
Run harnessc from anywhere inside a repository. It searches upward for
./.harness/harness.toml, validates the selected config, explains source or
output paths, and prints the next useful command.
Privacy And Telemetry
Harness config does not collect telemetry. The harnessc CLI does not send
analytics, usage events, file paths, repository names, command history, machine
identifiers, or error reports. Activation, validation, and planning run locally
against files in your repository, and the CLI does not make network requests
during normal operation.
Quick Start
npx harnessc
npx harnessc init
npx harnessc validate
npx harnessc explain .agents/skills/review/SKILL.md
npx harnessc activate
npx harnessc activate --yesCommon Commands
harnessc
harnessc init
harnessc validate
harnessc explain .agents/skills/review/SKILL.md
harnessc activate
harnessc activate --yesharnessc explain <path> is read-only introspection. It can explain a
projected output such as .agents/skills/review/SKILL.md, a repo-relative dir
output such as AGENTS.md, or a configured source path such as
.harness/local/resources/skills/review/SKILL.md. With --json, it includes
source and target-output .harnessIgnore traces so automation can see the
winning rule.
Filesystem Semantics
- Symlinks are treated as leaf entries and are not followed.
- Target symlinks that occupy projected paths are conflicts unless replacement is explicitly selected.
- Managed target files update from the current source projection.
- Files declared in
.harnessMutableare created once, then left to the runtime. - Unmanaged target files are preserved unless cleanup is explicit.
- Target-output
.harnessIgnoreand.harnessProfilefiles are protected local controls. - Fixed inputs produce deterministic activation plans.
Links
- Website: https://www.harnessconfig.dev/
- Specification proposal: https://www.harnessconfig.dev/specifications/v1/
- GitHub: https://github.com/reachjalil/harness-config
- Release notes: https://github.com/reachjalil/harness-config/blob/main/docs/RELEASE_NOTES.md
- Issues: https://github.com/reachjalil/harness-config/issues
- Security policy: https://github.com/reachjalil/harness-config/security/policy
Packages
harnessc: public npm CLI package.@harnessconfig/cli: scoped implementation package used byharnessc.@harnessconfig/core: TypeScript reference implementation for tools.
