tenex-tools

Share, discover, and integrate LLM coding instructions & code snippets to supercharge your AI coding agents.

🚀 Overview

As AI-powered coding assistants become a staple in development workflows, the key to unlocking their full potential is guiding them with precise, battle-tested instructions and code recipes. tenex-tools provides a collaborative registry and CLI for publishing, finding, and integrating:

Micro-Instructions: Turn common coding tasks into LLM-friendly step-by-step guides.
Code Snippets: Share reusable code patterns that dramatically reduce errors and improve quality.
Agent Profiles: Define custom agent personas and workflows to automate complex tasks.

By tapping into a community-driven marketplace of LLM assets, you can radically improve the performance, reliability, and consistency of your AI coding agents.

⭐ Key Benefits

Accelerate Agent Accuracy: Snippets and instructions sharpen an LLM’s focus on your coding conventions and best practices.
Collaborative Growth: Publish your own assets, build your reputation, and leverage community contributions.
Plug & Play: Seamlessly integrate with any MCP-compatible agent or workflow.
Search & Discover: Find the exact snippet or workflow you need with rich filtering by tags, languages, and authors.

🔧 Features

Publish & Retrieve Instructions
tenex-tools instructions find <query>
tenex-tools instructions publish <file>
Search & Fetch Code Snippets
tenex-tools find-snippets [--limit <n>] [--languages <list>] [--tags <list>] [--authors <list>]
Manage Custom Agent Profiles
tenex-tools agent find <query>
tenex-tools agent get <eventId> --roo [path]
tenex-tools agent publish <.roomodes path>
One-time Setup Wizard
tenex-tools setup
Advanced MCP Mode tenex-tools mcp

💡 Use Cases

Generate robust unit tests with curated TDD snippets
Automate refactoring workflows with step-by-step instructions
Create domain-specific agent personas (e.g., Security Auditor, Performance Tuner)
Share best practices across teams and projects

🚀 Getting Started

Install tenex-tools
```
bun install
```
Note: If you want to use tenex-tools globally, you can link it after building:
```
bun run build
bun link
```
Run the setup wizard
```
bun run index.ts setup
```

Find and install a code snippet

tenex-tools find-snippets --limit 5 --languages javascript,python --tags testing

Discover agent workflows

tenex-tools agent find "refactor"

Fetch and save an instruction set

tenex-tools instructions find "optimize imports" --out .roo/rules-code/

📖 CLI Reference

Setup

tenex-tools setup

Find Snippets

tenex-tools find-snippets [--limit <n>] [--languages <list>] [--tags <list>] [--authors <list>]

Instructions

tenex-tools instructions find <query> [--out <path>]
tenex-tools instructions publish <file>

Agents

tenex-tools agent find <query>
tenex-tools agent get <eventId> --roo [path]
tenex-tools agent publish <.roomodes path>

🤝 Contributing

We welcome new snippets, instructions, and agent profiles! To contribute:

Fork this repo and clone.
Add your assets under assets/, or publish directly with the CLI.
Submit a PR or share your contributions via the community registry.

📜 License

MIT

Tenex Tools