Skip to main content

Attune Harness FAQ

Specifications, scoped work and checkable results.

Start with Harness. Earlier project references are available separately below.

Attune Harness

What is Attune Harness?

Attune Harness is an open-source toolkit for AI-assisted engineering. It helps you define scoped work, record permitted actions, and inspect the results and the checks behind them.

Can I use it for specification development?

Work with your agent to develop requirements, constraints and acceptance criteria, then agree with the scope before authorizing execution. Harness supports planning, building, repair and test journeys. Native planning and building are experimental in 1.4.0; use the documented agent paths and review their limits.

How do I get started with Harness?

Follow the Harness Quick Start: create a separate Python 3.10+ environment, install attune-harness[all]==1.4.0, confirm the version and run the local example. Redis use needs a running service; Voyage retrieval needs an API key and makes paid calls.

What does a receipt tell me?

A receipt records the task outcome, captured output and check evidence. Look for independent checks alongside the output, and keep unchecked behavior separate. A passing check establishes only what that check assessed; it does not guarantee a correct change or a reliable model.

Which agents and models can I use with Attune Harness?

Harness has documented setup paths for Claude Code and Codex. Models and authentication depend on the host and participants configured for the task. Installing the Python package does not install agent plugins or skills. Native planning and building are experimental in 1.4.0. Browser forms in that release support draft intake, preview and intent approval; browser build dispatch is not available. Intent approval is separate from permission to execute paid work.

Does Harness replace Attune AI?

Harness runs without Attune AI, but does not yet replace every Attune AI workflow. Keep the two packages in separate environments and check the migration guide before changing an existing setup. The earlier Attune AI references remain available for existing users.

Does Harness keep all my data local?

Harness can read local memory and keep receipts on disk. Redis may run locally or remotely, depending on your setup. Authorized model calls or Voyage retrieval can send selected task context, source text or queries to a provider. Review the chosen workflow, destination and permissions before execution.

Earlier Attune AI references

These references apply to the earlier project. Open them if you maintain an existing Attune AI installation.

Attune AI — General

What is Attune AI?

Attune AI combines specification development, AI workflows, project memory, retrieval and verification tools. It is a separate project from Attune Harness, released under Apache 2.0. Provider access and setup depend on the workflow you choose.

What is the reliability loop?

Specify, Ground, Build, Remember and Verify describe a way to organize development: agree requirements, consult project sources, implement tasks, retain useful findings and check the result. This sequence is a working practice; it does not guarantee correct output or enforce every step in every workflow.

What is Attune AI built on?

Attune AI brings together project memory, structured forms, AI workflows, retrieval through attune-rag and verification tools. Their availability and behavior depend on the installed version and the integration in use. Review the selected workflow and its checks before relying on its output.

Where can I find the Attune AI capability reference?

The retained Attune AI documentation describes workflows, MCP tools, skills, wizards and template kinds. Use the reference for your installed version and inspect its available commands; a website count is not evidence that a capability is available in your environment.

What happened to attune-gui?

attune-gui was the local dashboard that sat on top of the attune-ai framework. The project was parked in July 2026: the repository is archived and no further releases are planned. Released versions stay installable from PyPI (pip install attune-gui), and the previously announced fold into attune-ai[gui] was cancelled. See the archive notice for details.

Do I need a dashboard?

A dashboard is not required for terminal workflows. CLI and plugin capabilities depend on your installed version and host. The earlier standalone attune-gui dashboard is archived; see the archive notice before relying on an existing installation.

Attune AI — Licensing & Pricing

How much does Attune AI cost?

Attune AI is open source under Apache 2.0. Hosted model calls and other external services may incur separate charges. Check the authentication route, provider terms and permissions for the workflow you intend to run.

What is the Apache 2.0 License?

Apache 2.0 permits use, modification and redistribution under its conditions. Redistribution obligations include preserving the license and relevant notices, and marking changed files. Read the license for the full terms, including patent provisions and warranty limits.

Can I use Attune AI for commercial projects?

Yes, Apache 2.0 permits commercial use subject to its conditions. Preserve required license and attribution notices when distributing the software. Model access and other services have their own terms and charges.

Attune AI — Technical

How does retrieval grounding help me check answers?

attune-rag retrieves project sources to supply context and citations for review. Check the cited material and the resulting answer. A retrieval evaluation measures a particular corpus, query set and configuration; it does not establish accuracy for every generated answer.

What does verification check?

Verification tools can check properties such as imports, command-line flags, links and capability counts against project sources. Inspect which checks ran, their results and any unchecked behavior. Passing those checks does not establish that all generated content is correct.

Is my code sent anywhere?

Local memory storage does not mean every Attune AI workflow stays on your machine. Hosted model calls can send the supplied code, prompts or task context to a provider. The location of Redis and embedding services depends on the configured setup. Review the workflow and its destinations before execution.

Do I need an API key?

Authentication depends on the host and workflow. A host-native Claude Code integration can use its supported login; a direct API route needs the credentials and billing required by that provider. Check the selected route before execution rather than assuming a subscription covers every call.

What platforms are supported?

Attune AI requires Python 3.10 or later. Check its installation guide and the requirements of your selected workflow, host and operating system. Python package availability does not establish compatibility with every IDE or integration.

Attune AI — Wizards

What are wizards?

Wizards are guided, multi-step workflows. Their questions, analysis and actions depend on the selected wizard. Consult the wizard reference for your installed Attune AI version and check its permissions before running it.

How do I run a wizard?

Use the wizard guide for your installed Attune AI version. Host commands and Python callbacks need the setup described by that guide; consult the retained documentation before running an example.

Can I create custom wizards?

Yes! Two approaches: (1) YAML-based — create a .attune/wizards/my-wizard.yaml file with step definitions, no Python required. (2) Python-based — subclass BaseWizard for advanced logic like workflow delegation, conditional steps, and custom result processing. See the Custom Wizard Development guide.

Attune AI — Use Cases

What can I build with Attune AI?

Attune AI provides workflows for code review, security scanning, test generation, bug prediction and refactor planning, alongside specification and memory tools. Use them to support development, then inspect the output and run checks appropriate to the change.

How does the spec engine work?

The spec engine runs via /spec. It guides you Socratically through requirements, design, and tasks with an approval gate, so a feature starts from an agreed spec rather than an open-ended prompt — the first stage of the reliability loop.

What happened to the Fair Source License?

The current Attune AI license is Apache 2.0. If you use an earlier release, inspect the license distributed with that release. This reference does not claim a reason for the historical licensing change.

Attune AI — Support & Community

Where can I get help?

Use the project documentation and GitHub community channels. Report Attune AI bugs in its issue tracker; use the Harness issue tracker for Harness. A pilot or support arrangement would need a separate discussion and agreement.

How do I report bugs?

Report bugs via GitHub Issues. Include your environment details, steps to reproduce, and expected vs actual behavior.

Can I contribute to the project?

Yes! We welcome contributions. Check out our GitHub repository for contribution guidelines. The framework is fully open source under Apache 2.0, making it easy to fork, modify, and contribute back.

Still Have Questions?

Read the release guide for setup and qualification details, or get in touch about a specific question.