Better Agents

Scaffold agent projects with testing, evaluation, prompt versioning, observability, and MCP-ready development conventions.

Stars
★ 1.6k
Last updated
6mo ago
License
MIT
Primary language
TypeScript

At a glance

How it runs
CLI
Works with
Universal · cross-platformClaude Code
Cost
Free software; you pay for model usage
Setup effort
Low · running in minutes
You'll need
Node.js 22+npm or pnpma supported coding assistantLangWatch API keyLLM provider API keyShell / CLINetwork accessLocal filesystemMCP Server
Typical use
A developer starting an Agno project with Claude Code who wants Scenario end-to-end tests and versioned prompts from the first iteration.
Not a fit if
  • Teams wanting a ready runtime: it only scaffolds projects
  • Teams avoiding a LangWatch cloud account and API key
  • Developers not using Claude Code, Cursor, Antigravity, or Kilocode
Maintenance
No commits for 6+ monthslast commit 2026-05-11latest release v0.1.23 (2026-02-22)

What does this agent do, and when should you use it?

Better Agents is a CLI and set of development standards for initializing new agent projects. It is designed to work alongside a selected agent framework, including Agno, Mastra, and LangGraph, and supported coding assistants such as Claude Code, Cursor, Antigravity, and Kilocode CLI. Its generated project layout includes application code, Scenario end-to-end tests, evaluation notebooks, versioned prompts, a prompt registry, MCP configuration, and AGENTS.md guidance. The product produces and standardizes a local project foundation; it is not documented as a hosted agent runtime. It fits teams that want testing, prompt collaboration, evaluation, and observability conventions in place from project creation.

Running better-agents init . or better-agents init my-awesome-agent starts an interactive CLI flow for selecting a programming language, agent framework, coding assistant, LLM provider, and API keys. It creates project assets including app/ or src/, tests/scenarios/, tests/evaluations/, prompts/, prompts.json, .mcp.json, AGENTS.md, .env, and .gitignore. tests/scenarios/ is for Scenario end-to-end conversational tests, while tests/evaluations/ holds datasets and notebooks for evaluating pipeline tasks such as RAG and classification. Prompts are stored as versioned YAML files under prompts/ and controlled through prompts.json; .mcp.json configures MCP servers for the selected coding assistant.

  1. A developer starting an Agno project with Claude Code who wants Scenario end-to-end tests and versioned prompts from the first iteration.
  2. A Mastra team that needs YAML prompt files and prompts.json to coordinate prompt work across collaborators.
  3. An engineering team building a LangGraph workflow with RAG or classification steps that needs a place for evaluation datasets and notebooks.
  4. A technical lead standardizing new agent repositories around MCP configuration, observability, tests, and project conventions.
  5. A Cursor, Antigravity, or Kilocode CLI user who wants a consistent starting structure for a new agent codebase.

Key setup facts

Pulled from the install and usage notes below. The project README has the current values.

Install / run
  • npm install -g @langwatch/better-agents
  • npx @langwatch/better-agents init my-agent-project
Runtime
Node.js 22+

How do you install or deploy this agent?

Requirements are Node.js 22+, npm or pnpm, a supported coding assistant, a LangWatch API key, and an API key for the selected LLM provider. Install globally with npm install -g @langwatch/better-agents. Or run without a global installation: npx @langwatch/better-agents init my-agent-project.

How do you use this agent?

Initialize the current directory with better-agents init ., or create and initialize a new directory with better-agents init my-awesome-agent. Follow the CLI prompts to select the language, framework, coding assistant, LLM provider, and required API keys. Anonymous usage telemetry is enabled by default; set BETTER_AGENTS_TELEMETRY=0 to opt out.

What are this agent's strengths and limitations?

Pros
  • Scaffolds Scenario end-to-end testing, evaluation notebooks, versioned prompts, and a prompt registry together rather than only creating application folders.
  • Includes .mcp.json so MCP configuration for the chosen framework and Scenario testing can be part of the new project.
  • The initialization flow supports choices of language, agent framework, coding assistant, and LLM provider.
  • Separates behavioral tests, offline evaluation work, and prompt assets into explicit tests/scenarios/, tests/evaluations/, and prompts/ locations.
Limitations
  • Requires Node.js 22+ and npm or pnpm.
  • Adoption requires both a LangWatch API key and an API key for the chosen LLM provider.
  • The documented coding-assistant choices are limited to Claude Code, Cursor, Antigravity, and Kilocode CLI.
  • It establishes project structure and guidance rather than supplying a deployed runtime; the actual framework implementation remains the project’s responsibility.

How does this agent compare with similar options?

Better Agents is complementary to Agno, Mastra, and LangGraph: those frameworks hold the agent implementation, while Better Agents scaffolds the surrounding testing, evaluation, prompt, and MCP conventions. It also works with, rather than replaces, coding assistants including Claude Code, Cursor, Antigravity, and Kilocode CLI.

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
Better Agents This agent 44 · Major gaps CLIFree + model costs ★ 1.6k 6mo ago TypeScript Claude Code
RocketRide 84 · Good — ★ 20k today Python —
Hypha 55 · Major gaps Self-hosted serviceFree + model costs ★ 452 5d ago TypeScript OpenAI API
Rulesync 71 · Some gaps CLIFree ★ 1.6k 1d ago TypeScript Codex · Claude Code

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
44/ 100 5-point scale 2.2 / 5
Trust 10/29
Reliability 5/14
Adaptability 9/18
Convention 10/18
Effectiveness 7/13
Verifiability 3/8
Why each dimension lost points
Trust10 / 29 · 1.7/5

The CLI requires API keys through environment variables and documents an opt-out for anonymous telemetry, reducing the risk of exposing keys in arguments. Telemetry is enabled by default, however, and the sample does not describe event fields or retention, so least privilege, data-flow transparency, and external-effects controls are only partial. Initialization automatically launches the selected coding assistant; confirmation and rollback for generated files or external actions are not documented. The MIT license is clear and the author field names LangWatch, but publisher identity is unverified and does not establish maintenance ownership.

Reliability5 / 14 · 1.8/5

The repository configures CI for type checking, build, lint, unit tests, and end-to-end tests; that shows a validation process exists, not its results. Node requirements conflict across sources (README says 22+, quick start says 18+, and package.json says >=18), as do some assistant and framework lists. Failure behavior is only lightly documented, including initialization and telemetry errors.

Adaptability9 / 18 · 2.5/5

The documentation targets developers building Python or TypeScript agents with coding assistants and names several frameworks, model providers, and setup modes. CLI options constrain language, framework, and goal, but supported combinations, capability boundaries, and environment compatibility are not fully documented; automatic assistant launch also limits workflow flexibility.

Convention10 / 18 · 2.8/5

README, quick start, usage guide, license, and changelog entry provide a usable information structure, install commands, and concrete examples. The MIT text is complete and a package version is present, but requirements and feature lists conflict across documents, known limitations are not covered, and maintenance responsibility is not clearly established. A contributing guide is linked but its contents are not included.

Effectiveness7 / 13 · 2.7/5

The product offers a project structure for agent code, tests and evaluations, prompt management, and coding-assistant context, giving new projects a potentially useful starting point. The sample supports these benefits mainly through feature descriptions; it does not show generated output details or cost evidence. Default telemetry and API-key setup add configuration overhead.

Verifiability3 / 8 · 1.9/5

Operational claims about installation, options, and environment variables are partly represented in both CLI code and documentation, while stronger claims such as production readiness and ensuring best practices lack outcome evidence in this sample. README, quick start, and package.json disagree on Node requirements and supported options. This is a static sample, so behavior and test outcomes remain unverified.

Risks and how to mitigate them
  • Not found in source: rollback or recovery pathBack up first, or work on a git branch or snapshot, so its changes can be undone.
  • Node.js requirements and some assistant/framework lists differ across the README, quick start, usage guide, and package.json; check the actual CLI options before relying on a documented combination.
  • Telemetry is enabled by default. The sample gives an opt-out variable but does not describe collected fields, destination details, or retention.
  • The selected coding assistant is automatically launched after setup; the sample does not describe overwrite confirmation or recovery for generated files.
Evidence confidence: Low Reviewed Nov 08, 2026 Reviewed revision 00c44b92fafc
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/better-agents.svg)](https://followagents.com/en/agents/better-agents)
<a href="https://followagents.com/en/agents/better-agents"><img src="https://followagents.com/badge/better-agents.svg" alt="FARS review"></a>

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. v0.1.23
    Release notes excerpt
    [0.1.23](https://github.com/langwatch/better-agents/compare/v0.1.22...v0.1.23) (2026-02-22) Features * pass LANGWATCH_API_KEY to MCP server config ([#84](https://github.com/langwatch/better-agents/issues/84)) ([8ab576e](https://github.com/langwatch/better-agents/commit/8ab576ecc12eca6d1da3526983f04212d857ca6a))
    View on GitHub ↗
  2. v0.1.21
    Release notes excerpt
    [0.1.20](https://github.com/langwatch/better-agents/compare/v0.1.20...v0.1.20) (2025-12-11) Features * add non-interactive mode with CLI options ([#77](https://github.com/langwatch/better-agents/issues/77)) ([0ff5bd1](https://github.com/langwatch/better-agents/commit/0ff5bd1c74782ba6b808ac415906e666cf368552)) Miscellaneous * release v0.1.20 ([c799e6c](https://github.com/langwatch/better-agents/commit/c799e6cfc81120bf1f43848b44d272587967a7be))
    View on GitHub ↗
  3. v0.1.20
    Release notes excerpt
    [0.1.20](https://github.com/langwatch/better-agents/compare/v0.1.19...v0.1.20) (2025-12-09) Features * cursor-agent(mac) ([#59](https://github.com/langwatch/better-agents/issues/59)) ([75f51f7](https://github.com/langwatch/better-agents/commit/75f51f760346e35758348cafec4d6aac0a04f7da)) * vercel-ai ([#70](https://github.com/langwatch/better-agents/issues/70)) ([8aa9b11](https://github.com/langwatch/better-agents/commit/8aa9b11b98f8c16b6cfa2a2a61aa54793a4d9b09)) …
    View on GitHub ↗

FAQ

Does it deploy or run an agent for me?
No. Its documented role is to initialize project structure, configuration, and development conventions; agent code belongs in app/ or src/.
Which credentials are required?
You need a LangWatch API key and an API key for your selected LLM provider.
Can telemetry be disabled?
Yes. Set BETTER_AGENTS_TELEMETRY=0; anonymous usage telemetry is enabled by default.
Which coding assistants are explicitly supported?
Claude Code, Cursor, Antigravity, and Kilocode CLI are listed.
Is Better Agents free?
The software is free, but Better Agents calls an AI model, and you pay that model provider for usage (or run a local model).
Is Better Agents open source?
Yes. The source code is on GitHub (langwatch/better-agents) under the MIT licence.
Is Better Agents safe to use?
FollowAgents' FARS review (Nov 08, 2026) scored Better Agents 10/29 on trust and safety. The review did not find these safety controls in the source: rollback or recovery path. Before giving it real accounts or data: Back up first, or work on a git branch or snapshot, so its changes can be undone.
Is Better Agents still maintained?
The GitHub repository has had no commits since 2026-05-11, more than six months ago. That can mean the project is finished or abandoned; check its issues before relying on it. The latest release is v0.1.23 (2026-02-22).
Who makes Better Agents?
Better Agents is published on GitHub by the account langwatch. FollowAgents has not verified which person or company is behind that account.
Was this page helpful?
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related concepts