mrkeyoor.com_
Sat 07 Nov 04:18 UTC
LLM Toolsevaluationupdated 01 Nov 2026

gentle-ai review

Consider Gentle AI if you want shared configuration and workflows across coding agents you already use, and can inspect the configuration it writes. Gentle AI configures supported agents; Gentle Shell owns its own Pi runtime, agents, and interface. Our run on October 13, 2026, at commit f0b6e47 reached a placeholder Node test script, so it does not establish whether the Go implementation or agent workflows work.

+353stars / 7d
Verdict

Gentle AI is worth evaluating when shared agent configuration and workflow guidance solve a concrete problem for your team. Begin with a dry run and verify one selected integration before extending it. Our October 13, 2026 run at f0b6e47 tested a Node dependency step and placeholder test command, leaving the Go CLI, agent behavior, and review lifecycle untested. Choose Superpowers for its skills-based development process or Spec Kit for structured process artifacts when those are the narrower needs.

We ran it

Lab card: what happened when we ran gentle-aiScreenshot of gentle-ai (github.com/Gentleman-Programming/gentle-ai)
Install✓ · 15s0 packages · 1 MB
Buildn/ano build script
Tests✗ · 4sran, no count parsed
Repo2202 files~468,349 lines of source · 30.3 MB · 10 CI workflows

Answers from our run

Does gentle-ai build from source?

Dependencies installed in 15 seconds (0 packages), and the project has no separate build step. We cloned commit f0b6e47 into a clean Debian container with 3 CPUs and no project-specific setup.

Do gentle-ai's tests pass?

No. The project's own test command exited unsuccessfully after 4 seconds, and its output did not expose an individual test count.

Who should not use gentle-ai?

Readers seeking a tested recommendation for the Go CLI: our sandbox did not build or test it.

What are the alternatives to gentle-ai?

Superpowers, Spec Kit. Gentle AI is worth evaluating when shared agent configuration and workflow guidance solve a concrete problem for your team.

Setup2/5Considerable setup work under the visible rubric: the quickstart spans platform prerequisites, agent selection, generated configuration, asset sync, and post-install verification. Our successful Node step did not validate product installation.
Docs4/5Substantial documentation covers prerequisites, dry runs, verification, upgrades, and recovery. The supplied main README and quickstart show different stable installation examples, so version-specific checking remains necessary.
Community4/5Substantial participation evidence comes from the v2.4.0 release account of eight release candidates and fixes informed by reported runs. This score concerns participation evidence, not measured adoption, current tracker health, or support responsiveness.
Maturity3/5Release integrity, configuration backups, and documented recovery provide usable foundations. The v2.4.0 notes disclose material review limitations; our later checkout was not functionally tested, so reliability remains unverified.

Who it’s for

Developers who want shared workflow guidance, memory integration, skills, and model settings across supported coding agents.
Teams willing to inspect generated configuration and verify behavior in each selected agent.
Developers who understand that review evidence is informational and repository policy still governs delivery.

Who it’s NOT for

Readers seeking a tested recommendation for the Go CLI: our sandbox did not build or test it.
Teams that cannot permit a configurator to write agent settings.
Anyone expecting identical behavior across integrations: the pinned README says native capabilities differ.
Teams expecting a review receipt to authorize commits, pushes, or releases.

Setup reality

Our run on October 13, 2026, at commit f0b6e47 used our Node 22 sandbox with 3 CPUs and 8 GB RAM. The stored harness summary records a successful 15-second pnpm install, 0 dependency packages, and a 1 MB dependency footprint. Build was skipped because there was no build script. The test command exited 1 after 4 seconds; its captured output says "Error: no test specified".

These are command outcomes from a Node-oriented harness, not a successful Gentle AI installation. The harness detected Node, Go, and Python but selected Node as primary. It did not run a Go build, Go tests, an agent session, or the receipt-review lifecycle. The checkout measurements were 2,202 files, 468,349 source lines, and 30.3 MB; those describe repository size, not runtime cost.

The supplied quickstart lists Git, Go 1.25.10+ for source builds, and Node.js 18+ with npm checks. It recommends an installation dry run, inspection of installed paths, and a read-only doctor check. Its current instructions must not be treated as proof of what our October sandbox executed.

What our run establishes

Our run on October 13, 2026, at commit f0b6e47 recorded a successful Node dependency step and a failing placeholder test command. The attached summary records 15 seconds for installation and 4 seconds for testing. The raw install tail also contains pnpm's own "Done in 1.2s" message; that is the package manager's report, not the harness's elapsed step time.

The test tail prints "Error: no test specified" and exits 1. This establishes that the selected Node test command failed. It does not establish a failure in Gentle AI's Go implementation or receipt-review workflow. Build was skipped, not failed. No parsed test counts were recorded, so there is no passing-test total or coverage claim to report.

Our harness preserves each step's status, elapsed time, exit code, timeout flag, and captured output tail. The exact stored record is the basis for this account. The MrKeyoor testing methodology explains that reporting approach and its limits; the supplied methodology page was fetched after this run and does not establish which procedure version the older run used. No new execution was performed for this correction. The audit field is null, so neither advisory results nor scan coverage are established.

What Gentle AI adds to an existing agent

The README pinned to our measured commit describes shared workflow guidance, Engram memory integration, skills, optional documentation access through Context7 MCP, configuration backups, and model assignment where supported. It lists 17 integrations and warns that features such as delegation and review depend on each agent's native capabilities.

Gentle AI configures supported agents; Gentle Shell owns its own Pi runtime, agents, and interface. The distinction matters when choosing an installation path: updating the Gentle AI binary alone does not establish Gentle Shell behavior or parity across agents.

The pinned README describes Organic Driven Development as keeping understood work lightweight while giving substantial authorized work a recoverable feature document. That is a documented workflow policy. Our sandbox did not test whether an agent follows it reliably, retains useful context, or produces better changes.

Review defaults depend on the version

The README at our measured commit describes RDD as on by default and opt-out, with informational results. It binds evidence to a frozen candidate and leaves delivery decisions to the user. Our run did not exercise that lifecycle.

The v2.4.0 release made review opt-in; the README at our measured commit describes it as on by default and opt-out. These sources describe different states of the project. The v2.4.0 release notes identify release commit 301fb2ad, which is not our measured commit f0b6e47. Their CI claims and known issues apply to those release bytes, not automatically to our checkout.

For v2.4.0 specifically, the release notes identify authority-lock scaling, a refusal loop involving a path over 4 MiB, and missing lineage retention among its known issues. Those are documented release limitations, not failures reproduced by our sandbox. Check the documentation for the version you intend to install before relying on a default or recovery procedure.

Evaluate the configuration before adopting it

Use the documented installation dry run to inspect the proposed selections and destinations. After a controlled installation, check the generated configuration and run the selected agent against a small task with an outcome you can verify. Test memory, tools, and review separately if they are reasons for adopting the system.

The supplied quickstart says a manual binary update needs a subsequent asset sync. It also documents a read-only doctor command for binaries, state validity, Engram reachability, and disk space. Those checks are useful preparation; a passing health check would still leave actual agent behavior to verify.

The current source extracts contain differing installation examples: the main README shows v4.1.1 while the quickstart labels v4.0.0 as stable. Neither changes the identity of our recorded checkout or proves that an installation command was executed in our sandbox.

Alternatives answer different needs

Superpowers provides a development methodology through composable skills and requires a separate installation for each harness. Consider it when the main requirement is a prescribed planning, testing, and review process. Its README does not establish a replacement for every Gentle AI configuration or memory feature, and it provides no basis for calling it smaller or faster.

Spec Kit provides structured processes, reusable templates, and documented outcomes for AI coding agents. Consider it when specifications, bug-fixing records, or idea assessments are the work you need to organize. Its supplied README describes these as independent entry points. It is a process alternative for that need, not evidence of equivalent memory or configuration management.

How to read the scores

These editorial scores use a five-point rubric: 1 means substantial documented barriers, 2 means considerable setup or operating work, 3 means usable foundations with material qualifications, 4 means substantial supporting documentation or participation evidence, and 5 requires strong evidence with few material qualifications for the dimension. They are judgments about the supplied evidence, not benchmark results or adoption measurements. Community assesses visible participation, not user count; maturity distinguishes release and recovery mechanisms from verified reliability.

Alternatives

ProjectWhat it isPick it when
Superpowers gh↗A development methodology built from composable coding-agent skills.Choose it when planning, test-first implementation, and review practices are the main need, and separate installation for each harness is acceptable. It is a process alternative, not an established replacement for all Gentle AI integrations.
Spec Kit gh↗A toolkit for structured coding-agent processes, reusable templates, and documented outcomes.Choose it when you need specification work, bug-fixing records, or idea assessment. Treat it as a process alternative rather than an established substitute for Gentle AI's memory and configuration features.

What people are saying

  1. [github-trending] Gentleman-Programming/gentle-ai

Sources

  1. Gentle AI repository and README
  2. Gentle AI quickstart and prerequisites
  3. Gentle AI v2.4.0 release
  4. Claude Code review lens frontmatter report
  5. OpenCode stale binary authority report
  6. Fresh SDD attempt authority failure report

More llm tools reviews

MCPJungle · octomind · kimi-k3-in-c · nanochat · FreeToken · ironclaw · the whole board →