--- title: "better-agents" type: "tool" slug: "langwatch-better-agents" canonical_url: "https://www.graphcanon.com/tools/langwatch-better-agents" github_url: "https://github.com/langwatch/better-agents" homepage_url: null stars: 1541 forks: 154 primary_language: "TypeScript" license: "MIT" categories: ["developer-tools", "ai-agents", "evaluation-observability"] tags: ["llmops", "lllm", "agent-framework", "dev-tool", "ai-agents", "cli"] updated_at: "2026-07-07T19:48:12.50361+00:00" --- # better-agents > A CLI tool and set of standards to create robust coding assistants Better Agents is a TypeScript-based Command Line Interface (CLI) that offers guidelines, structures, and tools for developing high-quality AI agents. It supports version-controlled prompts, evaluation notebooks, and scenario tests ensuring best practices. ## Facts - Repository: https://github.com/langwatch/better-agents - Stars: 1,541 · Forks: 154 · Open issues: 15 · Watchers: 7 - Primary language: TypeScript - License: MIT - Last pushed: 2026-06-03T17:12:53+00:00 ## Categories - [Developer Tools](/categories/developer-tools.md) - [AI Agents](/categories/ai-agents.md) - [Evaluation & Observability](/categories/evaluation-observability.md) ## Tags llmops, lllm, agent-framework, dev-tool, ai-agents, cli ## Related tools - [ECC](/tools/affaan-m-ecc.md) - The agent harness performance optimization system (★ 226,991) - [hermes-agent](/tools/nousresearch-hermes-agent.md) - The self-improving AI agent built by Nous Research (★ 210,911) - [AutoGPT](/tools/significant-gravitas-autogpt.md) - AutoGPT: Build, Deploy, and Run AI Agents (★ 185,420) - [ollama](/tools/ollama-ollama.md) - Get up and running with Kimi-K2.6, GLM-5.1, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models. (★ 175,664) - [prompts.chat](/tools/f-prompts-chat.md) - The world's largest open-source prompt library for AI (★ 165,025) - [JavaGuide](/tools/snailclimb-javaguide.md) - Snailclimb/JavaGuide: 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发 (★ 156,863) - [langflow](/tools/langflow-ai-langflow.md) - Langflow is a powerful platform for building and deploying AI-powered agents and workflows. (★ 151,311) - [dify](/tools/langgenius-dify.md) - Production-ready platform for agentic workflow development (★ 148,074) ## README (excerpt) ```text # Better Agents

chat on Discord

Better Agents is a CLI tool and a set of standards for agent building. It supercharges your coding assistant (Kilocode, Claude Code, Cursor, etc), making it an expert in any agent framework you choose (Agno, Mastra, LangGraph etc) and all their best practices. It's the best way to start any new agent project. The Better Agent Structure and generated AGENTS.md ensures industry best practices, making your agent ready for production: - [Scenario](https://github.com/langwatch/scenario) agent tests written for every feature to ensure agent behaviour - Versioning of the prompts for collaboration - Evaluation notebooks for measuring specific prompts performance - Already instrumented for full observability - Standardization of structure for better project maintainability ## The Better Agent Structure ``` my-agent-project/ ├── app/ (or src/) # The actual agent code, according to the chosen framework ├── tests/ │ ├── evaluations/ # Jupyter notebooks for evaluations │ │ └── example_eval.ipynb │ └── scenarios/ # End-to-end scenario tests │ └── example_scenario.test.{py,ts} ├── prompts/ # Versioned prompt files for team collaboration │ └── sample_prompt.yaml ├── prompts.json # Prompt registry ├── .mcp.json # MCP server configuration ├── AGENTS.md # Development guidelines ├── .env # Environment variables └── .gitignore ``` The structure and guidelines on `AGENTS.md` ensure every new feature required for the coding assistant is properly tested, evaluated, and that the prompts are versioned. The `.mcp.json` comes with all the right MCPs set up so you coding assistant becomes an expert in your framework of choice and in writing Scenario tests for your agent. [`scenarios/`](https://github.com/langwatch/scenario) tests guarantee the agent behaves as expected, which simulates a conversation with the agent making sure it does what expected. [`evaluations/`](https://docs.langwatch.ai/llm-evaluation/offline/code/evaluation-api) notebooks holds dataset and notebooks for evaluating pieces of your agent pipeline such as a RAG or classification tasks it must do Finally, [`prompts/`](https://docs.langwatch.ai/prompt-management/cli) hold all your versioned prompts in yaml format, synced and controlled by `prompts.json`, to allow for playground and team collaboration. ## Getting Started ### Installation ```bash npm install -g @langwatch/better-agents ``` Or use with npx: ```bash npx @langwatch/better-agents init my-agent-project ``` ### Initialize a new project ```bash # In current directory better-agents init . # In a new directory better-agents init my-awesome-agent ``` The CLI will guide you through selecting your programming language, agent framework, coding assistant, LLM provider, and API keys. ## Documentation - **[Getting Started](docs/GETTING-STARTED.md)** - Quick start guide (2 minutes) - **[Walkthrough](docs/WALKTHROUGH.md)** - Detailed step-by-step guide - **[Project Structure](docs/STRUCTURE.md)** - Understanding the Better Agent structure - **[Features](docs/FEATURES.md)** - Key features and capabilities - **[Usage](docs/USAGE.md)** - CLI usage and examples - **[Philosophy](docs/PHILOSOPHY.md)** - Agent Testing Pyramid approach - **[Contributing](docs/CONTRIBUTING.md)** - How to contribute to Better Agents - **[Changelog](CHANGELOG.md)** - Version history ## Requirements - Node.js 22+ - npm or pnpm - A coding assistant (one of the following): - [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code-agent) (`claude` CLI) - [Cursor](https://www.cursor.com/) - [Antigravity](https://antigravity.google/) (`agy`) - [Kiloco ``` --- **Machine-readable endpoints** - JSON: [`/api/graphcanon/tools/langwatch-better-agents`](/api/graphcanon/tools/langwatch-better-agents) - LLM index: [/llms.txt](/llms.txt) - Full corpus: [/llms-full.txt](/llms-full.txt) _GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_