Skip to content

pedroffd/synax

Repository files navigation

Synax CLI 🚀

Website NPM Version

The ultimate CLI to initialize and manage AI-ready projects. Synax establishes a "Persistent Context" bridge between you and your AI agents (Antigravity, Cursor, Claude Code, etc.), ensuring your projects are built with professional-grade engineering and design standards.

🌟 Features

  • Project Initialization: Setup AGENTS.md, PROJECT_CONTEXT.md, and a custom domain-expert skill in seconds.
  • Categorized Skill Library: Injects specialized AI personas (Architects, Bug Hunters, Security Engineers) and Visual Design experts.
  • Quality Guard: Native Husky + Commitlint integration to enforce Conventional Commits.
  • Context Bridge: Automatically syncs skills and rules to .cursorrules and other agent-specific directories.
  • Security Audit: Scans for secrets and API keys to prevent context leakage.

🚀 Getting Started

1. Installation

You can run Synax without installation using npx:

npx synax-cli@latest [command]

Or install it globally:

npm install -g synax-cli

2. Usage Tutorial

Initialize a New Project

Run this in any new codebase to prepare it for AI. It will detect your frameworks and suggest relevant skills.

npx synax-cli@latest init

Add a Specific Skill

Want to inject a specialized persona or framework knowledge?

npx synax-cli@latest add          # Opens interactive selection menu
npx synax-cli@latest add nextjs   # Directly installs Next.js skill

Audit Context

Check if your project has secrets exposed in code or if your context files are getting too large.

npx synax-cli@latest audit

Sync Bridge

Consolidate all installed skills and rules into a single source of truth for your AI Agent.

npx synax-cli@latest bridge

🛠️ Specialized Skills Library

Category Skill Description
Engineers architect Architectural strategy and trade-offs evaluator.
Engineers bug-hunter Laser-focused debugging and log analysis.
Engineers quality Production standards and API contract auditor.
Engineers security-engineer Security auditing, STRIDE and OWASP expert.
Designers ui-ux-pro-max Comprehensive database of UI/UX guidelines.
Designers ui-design-system Design tokens and component architecture.
Designers design-md Design-to-Dev synthesis (Stitch).
Designers image-enhancer utility for screenshot/asset enhancement.
Frameworks nextjs Next.js App Router & Server Actions.
Frameworks nestjs NestJS Modular backend patterns.
Frameworks django Django backend and Python security.
Frameworks vue Vue.js 3 / Nuxt frontend development.
Frameworks python General purpose Python expertise.

📚 Credits & Attribution

I didn't build everything from scratch; I transformed and bundled great tools to make them accessible. Here are the amazing authors whose skills inspired Synax:

Skill / Tool Author Repository / Source
Husky Typicode GitHub
Commitlint Conventional Commits GitHub
Caveman Julius Brussee GitHub
Serena Serena MCP GitHub
Django Expert jeffallan MCP Market
Python Expert rstarkey MCP Market
Vue TDD ssiertsema MCP Market
Design MD Google Labs Stitch

📄 License

MIT

About

Helpers for production-ready systems launch

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors