GitHub Trending

oh-my-codex (OMX) Multi-agent orchestration layer for OpenAI Codex CLI. Inspired by oh-my-claudecode. What is this? OMX brings 30 specialized agent roles, 39 workflow skills, mode lifecycle management, team orchestration, verification protocols, and notification systems to Codex CLI -- without forking the upstream project. Architecture User -> Codex CLI -> AGENTS.md (orchestration brain) -> ~/.codex/prompts/*.md (30 agent slash commands) -> ~/.agents/skills/*/SKILL.md (39 skills) -> config.toml (MCP servers, notify hook, features) -> .omx/ (state, memory, notepad, plans) Key design decision: OMX is an add-on, not a fork. It uses Codex CLI's native extension points: | Extension Point | What OMX Uses It For | |----------------|---------------------| | AGENTS.md | Orchestration brain (equivalent to CLAUDE.md) | | ~/.codex/prompts/*.md | 30 agent definitions as slash commands | | ~/.agents/skills/*/SKILL.md | 39 workflow skills | | config.toml MCP servers | State management + project memory | | config.toml notify | Post-turn logging and metrics | | config.toml features | collab (sub-agents), child_agents_md | Quick Start Install npm install -g oh-my-codex Setup (installs prompts, skills, configures Codex CLI) omx setup Verify installation omx doctor Start using in Codex CLI codex /architect "analyze the auth module" /autopilot "build a REST API for user management" /team 3:executor "fix all TypeScript errors" Setup Details omx setup performs these steps: Creates directories (/.codex/prompts/, /.agents/skills/, .omx/state/) Installs 30 agent prompt files to ~/.codex/prompts/ Installs 39 skill SKILL.md files to ~/.agents/skills/ Updates ~/.codex/config.toml with MCP servers and features Generates AGENTS.md in the current project root Configures the notify hook for post-turn logging Agent Catalog (30 agents) Build & Analysis | Agent | Model | Description | |-------|-------|-------------| | /explore | haiku | Codebase discovery, symbol/file mapping | | /analyst | opus | Requirements clarity, acceptance criteria | | /planner | opus | Task sequencing, execution plans | | /architect | opus | System design, boundaries, interfaces | | /debugger | sonnet | Root-cause analysis, failure diagnosis | | /executor | sonnet | Code implementation, refactoring | | /deep-executor | opus | Complex autonomous goal-oriented tasks | | /verifier | sonnet | Completion evidence, claim validation | Review | Agent | Model | Description | |-------|-------|-------------| | /style-reviewer | haiku | Formatting, naming, lint conventions | | /quality-reviewer | sonnet | Logic defects, anti-patterns | | /api-reviewer | sonnet | API contracts, versioning | | /security-reviewer | sonnet | Vulnerabilities, OWASP Top 10 | | /performance-reviewer | sonnet | Hotspots, complexity optimization | | /code-reviewer | opus | Comprehensive review across concerns | Domain Specialists | Agent | Model | Description | |-------|-------|-------------| | /dependency-expert | sonnet | External SDK/API evaluation | | /test-engineer | sonnet | Test strategy, coverage | | /quality-strategist | sonnet | Release readiness, risk assessment | | /build-fixer | sonnet | Build/toolchain failures | | /designer | sonnet | UX/UI architecture | | /writer | haiku | Docs, migration notes | | /qa-tester | sonnet | Interactive CLI validation | | /scientist | sonnet | Data/statistical analysis | | /git-master | sonnet | Commit strategy, history hygiene | Product | Agent | Model | Description | |-------|-------|-------------| | /product-manager | sonnet | Problem framing, PRDs | | /ux-researcher | sonnet | Heuristic audits, usability | | /information-architect | sonnet | Taxonomy, navigation | | /product-analyst | sonnet | Product metrics, experiments | Coordination | Agent | Model | Description | |-------|-------|-------------| | /critic | opus | Plan/design critical challenge | | /vision | sonnet | Image/screenshot analysis | Skills (39 skills) Execution Modes autopilot - Full autonomous execution from idea to working code ralph - Persistence loop with architect verification ultrawork - Maximum parallelism with parallel agent orchestration team - N coordinated agents on shared task list pipeline - Sequential agent chaining with data passing ecomode - Token-efficient execution using haiku and sonnet ultrapilot - Parallel autopilot with file ownership partitioning ultraqa - QA cycling: test, verify, fix, repeat swarm - Compatibility facade over team Planning plan - Strategic planning with optional consensus/review modes ralplan - Consensus planning (planner + architect + critic) Agent Shortcuts analyze - Deep analysis and investigation deepsearch - Thorough codebase search tdd - Test-driven development workflow build-fix - Fix build and TypeScript errors code-review - Comprehensive code review security-review - Security vulnerability review frontend-ui-ux - UI/UX design work git-master - Git operations review - Plan review/critique Utilities cancel - Cancel any active mode doctor - Diagnose installation issues help - Usage guide note - Save notes to notepad trace - Agent flow trace timeline skill - Manage local skills learner - Extract learned skills research - Parallel research agents deepinit - Deep codebase init with AGENTS.md release - Automated release workflow hud - Status display configuration omx-setup - Setup and configure OMX configure-telegram - Telegram notifications configure-discord - Discord notifications writer-memory - Writer memory system project-session-manager / psm - Isolated dev environments ralph-init - Initialize PRD for ralph-loop learn-about-omx - OMX usage patterns MCP Servers OMX provides two MCP servers that Codex CLI connects to via config.toml: State Server (omx_state) Manages mode lifecycle state for all execution modes. state_read / state_write / state_clear state_list_active / state_get_status Supports: autopilot, ralph, ultrawork, ecomode, ultrapilot, team, pipeline, ultraqa, ralplan Memory Server (omx_memory) Project memory and session notepad. project_memory_read / project_memory_write project_memory_add_note / project_memory_add_directive notepad_read / notepad_write_priority / notepad_write_working / notepad_write_manual Team Orchestration The team skill provides a staged pipeline: team-plan -> team-prd -> team-exec -> team-verify -> team-fix (loop) Each stage uses specialized agents. The verify/fix loop is bounded by max attempts to prevent infinite loops. Terminal states: complete, failed, cancelled. Notification System Supports three channels (configured in .omx/notifications.json): Desktop - Native notifications (macOS, Linux, Windows) Discord - Webhook integration with embedded messages Telegram - Bot API with Markdown formatting Verification Protocol Evidence-backed verification with task sizing: Small (20 files): Full check + security review + performance assessment + regression testing Hook Emulation Codex CLI has limited hook support (AfterAgent, AfterToolUse only). OMX emulates the full hook pipeline: | OMC Hook | OMX Equivalent | Capability | |----------|---------------|------------| | SessionStart | AGENTS.md native loading | Full | | PreToolUse | AGENTS.md inline guidance | Partial | | PostToolUse | notify config hook | Partial | | UserPromptSubmit | AGENTS.md self-detection | Partial | | SubagentStart/Stop | Codex CLI collab native | Full | | Stop | notify config | Full | Coverage ~92% feature parity with oh-my-claudecode (excluding MCP tools). See COVERAGE.md for the detailed feature matrix. Project Structure oh-my-codex/ bin/omx.js # CLI entry point src/ cli/ # CLI commands (setup, doctor, version, status, cancel, help) config/ # config.toml generator agents/ # Agent definitions registry mcp/ # MCP servers (state, memory) hooks/ # Hook emulation layer + keyword detector modes/ # Mode lifecycle management team/ # Team orchestration (staged pipeline) verification/ # Verification protocol notifications/ # Desktop/Discord/Telegram notifications utils/ # Path resolution, package utilities prompts/ # 30 agent prompt files (*.md) skills/ # 39 skill directories (*/SKILL.md) templates/ # AGENTS.md template scripts/ # notify-hook.js dist/ # Compiled output Development Install dependencies npm install Build npm run build Type check npx tsc --noEmit Link for local development npm link License MIT

GitHub Stars GitHub Forks License: MIT Version Claude Code Master Claude Code in a Weekend Go from typing claude to orchestrating agents, hooks, skills, and MCP servers — with visual tutorials, copy-paste templates, and a guided learning path. Get Started in 15 Minutes | Find Your Level | Browse the Feature Catalog Table of Contents The Problem How Claude How To Fixes This How It Works Not Sure Where to Start? Get Started in 15 Minutes What Can You Build With This? FAQ Contributing License The Problem You installed Claude Code. You ran a few prompts. Now what? The official docs describe features — but don't show you how to combine them. You know slash commands exist, but not how to chain them with hooks, memory, and subagents into a workflow that actually saves hours. There's no clear learning path. Should you learn MCP before hooks? Skills before subagents? You end up skimming everything and mastering nothing. Examples are too basic. A "hello world" slash command doesn't help you build a production code review pipeline that uses memory, delegates to specialized agents, and runs security scans automatically. You're leaving 90% of Claude Code's power on the table — and you don't know what you don't know. How Claude How To Fixes This This isn't another feature reference. It's a structured, visual, example-driven guide that teaches you to use every Claude Code feature with real-world templates you can copy into your project today. | | Official Docs | This Guide | |--|---------------|------------| | Format | Reference documentation | Visual tutorials with Mermaid diagrams | | Depth | Feature descriptions | How it works under the hood | | Examples | Basic snippets | Production-ready templates you use immediately | | Structure | Feature-organized | Progressive learning path (beginner to advanced) | | Onboarding | Self-directed | Guided roadmap with time estimates | | Self-Assessment | None | Interactive quizzes to find your gaps and build a personalized path | What you get: 10 tutorial modules covering every Claude Code feature — from slash commands to custom agent teams Copy-paste configs — slash commands, CLAUDE.md templates, hook scripts, MCP configs, subagent definitions, and full plugin bundles Mermaid diagrams showing how each feature works internally, so you understand why, not just how A guided learning path that takes you from beginner to power user in 11-13 hours Built-in self-assessment — run /self-assessment or /lesson-quiz hooks directly in Claude Code to identify gaps Start the Learning Path -> How It Works 1. Find your level Take the self-assessment quiz or run /self-assessment in Claude Code. Get a personalized roadmap based on what you already know. 2. Follow the guided path Work through 10 modules in order — each builds on the last. Copy templates directly into your project as you learn. 3. Combine features into workflows The real power is in combining features. Learn to wire slash commands + memory + subagents + hooks into automated pipelines that handle code reviews, deployments, and documentation generation. 4. Test your understanding Run /lesson-quiz topic] after each module. The quiz pinpoints what you missed so you can fill gaps fast. [Get Started in 15 Minutes Trusted by 5,900+ Developers 5,900+ GitHub stars from developers who use Claude Code daily 690+ forks — teams adapting this guide for their own workflows Actively maintained — synced with every Claude Code release (latest: v2.2.0, March 2026) Community-driven — contributions from developers who share their real-world configurations Star History Chart Not Sure Where to Start? Take the self-assessment or pick your level: | Level | You can... | Start here | Time | |-------|-----------|------------|------| | Beginner | Start Claude Code and chat | Slash Commands | ~2.5 hours | | Intermediate | Use CLAUDE.md and custom commands | Skills | ~3.5 hours | | Advanced | Configure MCP servers and hooks | Advanced Features | ~5 hours | Full learning path with all 10 modules: | Order | Module | Level | Time | |-------|--------|-------|------| | 1 | Slash Commands | Beginner | 30 min | | 2 | Memory | Beginner+ | 45 min | | 3 | Checkpoints | Intermediate | 45 min | | 4 | CLI Basics | Beginner+ | 30 min | | 5 | Skills | Intermediate | 1 hour | | 6 | Hooks | Intermediate | 1 hour | | 7 | MCP | Intermediate+ | 1 hour | | 8 | Subagents | Intermediate+ | 1.5 hours | | 9 | Advanced Features | Advanced | 2-3 hours | | 10 | Plugins | Advanced | 2 hours | Complete Learning Roadmap -> Get Started in 15 Minutes 1. Clone the guide git clone https://github.com/luongnv89/claude-howto.git cd claude-howto 2. Copy your first slash command mkdir -p /path/to/your-project/.claude/commands cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/ 3. Try it — in Claude Code, type: /optimize 4. Ready for more? Set up project memory: cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md 5. Install a skill: cp -r 03-skills/code-review ~/.claude/skills/ Want the full setup? Here's the 1-hour essential setup: Slash commands (15 min) cp 01-slash-commands/*.md .claude/commands/ Project memory (15 min) cp 02-memory/project-CLAUDE.md ./CLAUDE.md Install a skill (15 min) cp -r 03-skills/code-review ~/.claude/skills/ Weekend goal: add hooks, subagents, MCP, and plugins Follow the learning path for guided setup View the Full Installation Reference What Can You Build With This? | Use Case | Features You'll Combine | |----------|------------------------| | Automated Code Review | Slash Commands + Subagents + Memory + MCP | | Team Onboarding | Memory + Slash Commands + Plugins | | CI/CD Automation | CLI Reference + Hooks + Background Tasks | | Documentation Generation | Skills + Subagents + Plugins | | Security Audits | Subagents + Skills + Hooks (read-only mode) | | DevOps Pipelines | Plugins + MCP + Hooks + Background Tasks | | Complex Refactoring | Checkpoints + Planning Mode + Hooks | FAQ Is this free? Yes. MIT licensed, free forever. Use it in personal projects, at work, in your team — no restrictions beyond including the license notice. Is this maintained? Actively. The guide is synced with every Claude Code release. Current version: v2.2.0 (March 2026), compatible with Claude Code 2.1+. How is this different from the official docs? The official docs are a feature reference. This guide is a tutorial with diagrams, production-ready templates, and a progressive learning path. They complement each other — start here to learn, reference the docs when you need specifics. How long does it take to go through everything? 11-13 hours for the full path. But you'll get immediate value in 15 minutes — just copy a slash command template and try it. Can I use this with Claude Sonnet / Haiku / Opus? Yes. All templates work with Claude Sonnet 4.6, Claude Opus 4.6, and Claude Haiku 4.5. Can I contribute? Absolutely. See CONTRIBUTING.md for guidelines. We welcome new examples, bug fixes, documentation improvements, and community templates. Can I read this offline? Yes. Run uv run scripts/build_epub.py to generate an EPUB ebook with all content and rendered diagrams. Start Mastering Claude Code Today You already have Claude Code installed. The only thing between you and 10x productivity is knowing how to use it. This guide gives you the structured path, the visual explanations, and the copy-paste templates to get there. MIT licensed. Free forever. Clone it, fork it, make it yours. Start the Learning Path -> | Browse the Feature Catalog | Get Started in 15 Minutes Quick Navigation — All Features | Feature | Description | Folder | |---------|-------------|--------| | Feature Catalog | Complete reference with installation commands | CATALOG.md | | Slash Commands | User-invoked shortcuts | 01-slash-commands/ | | Memory | Persistent context | 02-memory/ | | Skills | Reusable capabilities | 03-skills/ | | Subagents | Specialized AI assistants | 04-subagents/ | | MCP Protocol | External tool access | 05-mcp/ | | Hooks | Event-driven automation | 06-hooks/ | | Plugins | Bundled features | 07-plugins/ | | Checkpoints | Session snapshots & rewind | 08-checkpoints/ | | Advanced Features | Planning, thinking, background tasks | 09-advanced-features/ | | CLI Reference | Commands, flags, and options | 10-cli/ | | Blog Posts | Real-world usage examples | Blog Posts | Feature Comparison | Feature | Invocation | Persistence | Best For | |---------|-----------|------------|----------| | Slash Commands | Manual (/cmd) | Session only | Quick shortcuts | | Memory | Auto-loaded | Cross-session | Long-term learning | | Skills | Auto-invoked | Filesystem | Automated workflows | | Subagents | Auto-delegated | Isolated context | Task distribution | | MCP Protocol | Auto-queried | Real-time | Live data access | | Hooks | Event-triggered | Configured | Automation & validation | | Plugins | One command | All features | Complete solutions | | Checkpoints | Manual/Auto | Session-based | Safe experimentation | | Planning Mode | Manual/Auto | Plan phase | Complex implementations | | Background Tasks | Manual | Task duration | Long-running operations | | CLI Reference | Terminal commands | Session/Script | Automation & scripting | Installation Quick Reference Slash Commands cp 01-slash-commands/*.md .claude/commands/ Memory cp 02-memory/project-CLAUDE.md ./CLAUDE.md Skills cp -r 03-skills/code-review ~/.claude/skills/ Subagents cp 04-subagents/*.md .claude/agents/ MCP export GITHUB_TOKEN="token" claude mcp add github -- npx -y @modelcontextprotocol/server-github Hooks mkdir -p ~/.claude/hooks cp 06-hooks/*.sh ~/.claude/hooks/ chmod +x ~/.claude/hooks/*.sh Plugins /plugin install pr-review Checkpoints (auto-enabled, configure in settings) See 08-checkpoints/README.md Advanced Features (configure in settings) See 09-advanced-features/config-examples.json CLI Reference (no installation needed) See 10-cli/README.md for usage examples Slash Commands Location: 01-slash-commands/ What: User-invoked shortcuts stored as Markdown files Examples: optimize.md - Code optimization analysis pr.md - Pull request preparation generate-api-docs.md - API documentation generator Installation: cp 01-slash-commands/*.md /path/to/project/.claude/commands/ Usage: /optimize /pr /generate-api-docs Learn More: Discovering Claude Code Slash Commands Memory Location: 02-memory/ What: Persistent context across sessions Examples: project-CLAUDE.md - Team-wide project standards directory-api-CLAUDE.md - Directory-specific rules personal-CLAUDE.md - Personal preferences Installation: Project memory cp 02-memory/project-CLAUDE.md /path/to/project/CLAUDE.md Directory memory cp 02-memory/directory-api-CLAUDE.md /path/to/project/src/api/CLAUDE.md Personal memory cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md Usage: Automatically loaded by Claude Skills Location: 03-skills/ What: Reusable, auto-invoked capabilities with instructions and scripts Examples: code-review/ - Comprehensive code review with scripts brand-voice/ - Brand voice consistency checker doc-generator/ - API documentation generator Installation: Personal skills cp -r 03-skills/code-review ~/.claude/skills/ Project skills cp -r 03-skills/code-review /path/to/project/.claude/skills/ Usage: Automatically invoked when relevant Subagents Location: 04-subagents/ What: Specialized AI assistants with isolated contexts and custom prompts Examples: code-reviewer.md - Comprehensive code quality analysis test-engineer.md - Test strategy and coverage documentation-writer.md - Technical documentation secure-reviewer.md - Security-focused review (read-only) implementation-agent.md - Full feature implementation Installation: cp 04-subagents/*.md /path/to/project/.claude/agents/ Usage: Automatically delegated by main agent MCP Protocol Location: 05-mcp/ What: Model Context Protocol for accessing external tools and APIs Examples: github-mcp.json - GitHub integration database-mcp.json - Database queries filesystem-mcp.json - File operations multi-mcp.json - Multiple MCP servers Installation: Set environment variables export GITHUB_TOKEN="your_token" export DATABASE_URL="postgresql://..." Add MCP server via CLI claude mcp add github -- npx -y @modelcontextprotocol/server-github Or add to project .mcp.json manually (see 05-mcp/ for examples) Usage: MCP tools are automatically available to Claude once configured Hooks Location: 06-hooks/ What: Event-driven shell commands that execute automatically in response to Claude Code events Examples: format-code.sh - Auto-format code before writing pre-commit.sh - Run tests before commits security-scan.sh - Scan for security issues log-bash.sh - Log all bash commands validate-prompt.sh - Validate user prompts notify-team.sh - Send notifications on events Installation: mkdir -p ~/.claude/hooks cp 06-hooks/*.sh ~/.claude/hooks/ chmod +x ~/.claude/hooks/*.sh Configure hooks in ~/.claude/settings.json: { "hooks": { "PreToolUse": { "matcher": "Write", "hooks": ["~/.claude/hooks/format-code.sh"] }], "PostToolUse": [{ "matcher": "Write", "hooks": ["~/.claude/hooks/security-scan.sh"] }] } } Usage: Hooks execute automatically on events Hook Types (4 types, 25 events): Tool Hooks: PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest Session Hooks: SessionStart, SessionEnd, Stop, StopFailure, SubagentStart, SubagentStop Task Hooks: UserPromptSubmit, TaskCompleted, TaskCreated, TeammateIdle Lifecycle Hooks: ConfigChange, CwdChanged, FileChanged, PreCompact, PostCompact, WorktreeCreate, WorktreeRemove, Notification, InstructionsLoaded, Elicitation, ElicitationResult Plugins Location: [07-plugins/ What: Bundled collections of commands, agents, MCP, and hooks Examples: pr-review/ - Complete PR review workflow devops-automation/ - Deployment and monitoring documentation/ - Documentation generation Installation: /plugin install pr-review /plugin install devops-automation /plugin install documentation Usage: Use bundled slash commands and features Checkpoints and Rewind Location: 08-checkpoints/ What: Save conversation state and rewind to previous points to explore different approaches Key Concepts: Checkpoint: Snapshot of conversation state Rewind: Return to previous checkpoint Branch Point: Explore multiple approaches from same checkpoint Usage: Checkpoints are created automatically with every user prompt To rewind, press Esc twice or use: /rewind Then choose from five options: 1. Restore code and conversation 2. Restore conversation 3. Restore code 4. Summarize from here 5. Never mind Use Cases: Try different implementation approaches Recover from mistakes Safe experimentation Compare alternative solutions A/B testing different designs Advanced Features Location: 09-advanced-features/ What: Advanced capabilities for complex workflows and automation Includes: Planning Mode — Create detailed implementation plans before coding Extended Thinking — Deep reasoning for complex problems (toggle with Alt+T / Option+T) Background Tasks — Run long operations without blocking Permission Modes — default, acceptEdits, plan, dontAsk, bypassPermissions Headless Mode — Run Claude Code in CI/CD: claude -p "Run tests and generate report" Session Management — /resume, /rename, /fork, claude -c, claude -r Configuration — Customize behavior in ~/.claude/settings.json See config-examples.json for complete configurations. CLI Reference Location: 10-cli/ What: Complete command-line interface reference for Claude Code Quick Examples: Interactive mode claude "explain this project" Print mode (non-interactive) claude -p "review this code" Process file content cat error.log | claude -p "explain this error" JSON output for scripts claude -p --output-format json "list functions" Resume session claude -r "feature-auth" "continue implementation" Use Cases: CI/CD pipeline integration, script automation, batch processing, multi-session workflows, custom agent configurations Example Workflows Complete Code Review Workflow Uses: Slash Commands + Subagents + Memory + MCP User: /review-pr Claude: Loads project memory (coding standards) Fetches PR via GitHub MCP Delegates to code-reviewer subagent Delegates to test-engineer subagent Synthesizes findings Provides comprehensive review Automated Documentation Uses: Skills + Subagents + Memory User: "Generate API documentation for the auth module" Claude: Loads project memory (doc standards) Detects doc generation request Auto-invokes doc-generator skill Delegates to api-documenter subagent Creates comprehensive docs with examples DevOps Deployment Uses: Plugins + MCP + Hooks User: /deploy production Claude: Runs pre-deploy hook (validates environment) Delegates to deployment-specialist subagent Executes deployment via Kubernetes MCP Monitors progress Runs post-deploy hook (health checks) Reports status Directory Structure ├── 01-slash-commands/ │ ├── optimize.md │ ├── pr.md │ ├── generate-api-docs.md │ └── README.md ├── 02-memory/ │ ├── project-CLAUDE.md │ ├── directory-api-CLAUDE.md │ ├── personal-CLAUDE.md │ └── README.md ├── 03-skills/ │ ├── code-review/ │ │ ├── SKILL.md │ │ ├── scripts/ │ │ └── templates/ │ ├── brand-voice/ │ │ ├── SKILL.md │ │ └── templates/ │ ├── doc-generator/ │ │ ├── SKILL.md │ │ └── generate-docs.py │ └── README.md ├── 04-subagents/ │ ├── code-reviewer.md │ ├── test-engineer.md │ ├── documentation-writer.md │ ├── secure-reviewer.md │ ├── implementation-agent.md │ └── README.md ├── 05-mcp/ │ ├── github-mcp.json │ ├── database-mcp.json │ ├── filesystem-mcp.json │ ├── multi-mcp.json │ └── README.md ├── 06-hooks/ │ ├── format-code.sh │ ├── pre-commit.sh │ ├── security-scan.sh │ ├── log-bash.sh │ ├── validate-prompt.sh │ ├── notify-team.sh │ └── README.md ├── 07-plugins/ │ ├── pr-review/ │ ├── devops-automation/ │ ├── documentation/ │ └── README.md ├── 08-checkpoints/ │ ├── checkpoint-examples.md │ └── README.md ├── 09-advanced-features/ │ ├── config-examples.json │ ├── planning-mode-examples.md │ └── README.md ├── 10-cli/ │ └── README.md └── README.md (this file) Best Practices Do's Start simple with slash commands Add features incrementally Use memory for team standards Test configurations locally first Document custom implementations Version control project configurations Share plugins with team Don'ts Don't create redundant features Don't hardcode credentials Don't skip documentation Don't over-complicate simple tasks Don't ignore security best practices Don't commit sensitive data Troubleshooting Feature Not Loading Check file location and naming Verify YAML frontmatter syntax Check file permissions Review Claude Code version compatibility MCP Connection Failed Verify environment variables Check MCP server installation Test credentials Review network connectivity Subagent Not Delegating Check tool permissions Verify agent description clarity Review task complexity Test agent independently Testing This project includes comprehensive automated testing: Unit Tests: Python tests using pytest (Python 3.10, 3.11, 3.12) Code Quality: Linting and formatting with Ruff Security: Vulnerability scanning with Bandit Type Checking: Static type analysis with mypy Build Verification: EPUB generation testing Coverage Tracking: Codecov integration Install development dependencies uv pip install -r requirements-dev.txt Run all unit tests pytest scripts/tests/ -v Run tests with coverage report pytest scripts/tests/ -v --cov=scripts --cov-report=html Run code quality checks ruff check scripts/ ruff format --check scripts/ Run security scan bandit -c pyproject.toml -r scripts/ --exclude scripts/tests/ Run type checking mypy scripts/ --ignore-missing-imports Tests run automatically on every push to main/develop and every PR to main. See TESTING.md for detailed information. EPUB Generation Want to read this guide offline? Generate an EPUB ebook: uv run scripts/build_epub.py This creates claude-howto-guide.epub with all content, including rendered Mermaid diagrams. See scripts/README.md for more options. Contributing Found an issue or want to contribute an example? We'd love your help! Please read CONTRIBUTING.md for detailed guidelines on: Types of contributions (examples, docs, features, bugs, feedback) How to set up your development environment Directory structure and how to add content Writing guidelines and best practices Commit and PR process Our Community Standards: CODE_OF_CONDUCT.md - How we treat each other SECURITY.md - Security policy and vulnerability reporting Reporting Security Issues If you discover a security vulnerability, please report it responsibly: Use GitHub Private Vulnerability Reporting: https://github.com/luongnv89/claude-howto/security/advisories Or read .github/SECURITY_REPORTING.md for detailed instructions Do NOT open a public issue for security vulnerabilities Quick start: Fork and clone the repository Create a descriptive branch (add/feature-name, fix/bug, docs/improvement) Make your changes following the guidelines Submit a pull request with a clear description Need help? Open an issue or discussion, and we'll guide you through the process. Additional Resources Claude Code Documentation MCP Protocol Specification Skills Repository - Collection of ready-to-use skills Anthropic Cookbook Boris Cherny's Claude Code Workflow - The creator of Claude Code shares his systematized workflow: parallel agents, shared CLAUDE.md, Plan mode, slash commands, subagents, and verification hooks for autonomous long-running sessions. Contributing We welcome contributions! Please see our Contributing Guide for details on how to get started. Contributors Thanks to everyone who has contributed to this project! | Contributor | PRs | |-------------|-----| | wjhrdy | #1 - add a tool to create an epub | | VikalpP | #7 - fix(docs): Use tilde fences for nested code blocks in concepts guide | License MIT License - see LICENSE. Free to use, modify, and distribute. The only requirement is including the license notice. Last Updated: March 2026 Claude Code Version: 2.1+ Compatible Models: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5

Open-Source Frontier Voice AI

!WARNING] This is very much in beta and might be buggy here and there (but hope you have a good experience!).   OpenScreen OpenScreen is your free, open-source alternative to Screen Studio (sort of). If you don't want to pay $29/month for Screen Studio but want a much simpler version that does what most people seem to need, making beautiful product demos and walkthroughs, here's a free-to-use app for you. OpenScreen does not offer all Screen Studio features, but covers the basics well! Screen Studio is an awesome product and this is definitely not a 1:1 clone. OpenScreen is a much simpler take, just the basics for folks who want control and don't want to pay. If you need all the fancy features, your best bet is to support Screen Studio (they really do a great job, haha). But if you just want something free (no gotchas) and open, this project does the job! OpenScreen is 100% free for personal and commercial use. Use it, modify it, distribute it. (Just be cool 😁 and give a shoutout if you feel like it !) Core Features Record specific windows or your whole screen. Add automatic or manual zooms (adjustable depth levels) and customize their durarion and position. Record microphone and system audio. Crop video recordings to hide parts. Choose between wallpapers, solid colors, gradients or a custom background. Motion blur for smoother pan and zoom effects. Add annotations (text, arrows, images). Trim sections of the clip. Customize the speed of different segments. Export in different aspect ratios and resolutions. Installation Download the latest installer for your platform from the [GitHub Releases page. macOS If you encounter issues with macOS Gatekeeper blocking the app (since it does not come with a developer certificate), you can bypass this by running the following command in your terminal after installation: xattr -rd com.apple.quarantine /Applications/Openscreen.app Note: Give your terminal Full Disk Access in System Settings > Privacy & Security to grant you access and then run the above command. After running this command, proceed to System Preferences > Security & Privacy to grant the necessary permissions for "screen recording" and "accessibility". Once permissions are granted, you can launch the app. Linux Download the .AppImage file from the releases page. Make it executable and run: chmod +x Openscreen-Linux-*.AppImage ./Openscreen-Linux-*.AppImage You may need to grant screen recording permissions depending on your desktop environment. Note: If the app fails to launch due to a "sandbox" error, run it with --no-sandbox: ./Openscreen-Linux-*.AppImage --no-sandbox Limitations System audio capture relies on Electron's desktopCapturer and has some platform-specific quirks: macOS: Requires macOS 13+. On macOS 14.2+ you'll be prompted to grant audio capture permission. macOS 12 and below does not support system audio (mic still works). Windows: Works out of the box. Linux: Needs PipeWire (default on Ubuntu 22.04+, Fedora 34+). Older PulseAudio-only setups may not support system audio (mic should still work). Built with Electron React TypeScript Vite PixiJS dnd-timeline I'm new to open source, idk what I'm doing lol. If something is wrong please raise an issue 🙏 Contributing Contributions are welcome! If you’d like to help out or see what’s currently being worked on, take a look at the open issues and the project roadmap to understand the current direction of the project and find ways to contribute. License This project is licensed under the MIT License. By using this software, you agree that the authors are not liable for any issues, damages, or claims arising from its use.

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

The agent that grows with you

Open Source AI Platform - AI Chat with advanced features that works with every LLM

TaxHacker: Self-Hosted AI Accounting GitHub Stars License Support Us !NOTE] ☝️ I'm currently looking for a job! Particularly interested in companies in Berlin or remote positions in Germany. Here's [my CV and Linkedin profile. Thank you 🙏 TaxHacker is a self-hosted accounting app designed for freelancers, indie-hackers, and small businesses who want to save time and automate expense and income tracking using the power of modern AI. Upload photos of receipts, invoices, or PDFs, and TaxHacker will automatically recognize and extract all the important data you need for accounting: product names, amounts, items, dates, merchants, taxes, and save it into a structured Excel-like database. You can even create custom fields with your own AI prompts to extract any specific information you need. The app features automatic currency conversion (including crypto!) based on historical exchange rates from the transaction date. With built-in filtering, multi-project support, import/export capabilities, and custom categories, TaxHacker simplifies reporting and makes tax filing a bit easier. 🎥 Watch demo video Dashboard \!IMPORTANT] This project is still in early development. Use at your own risk! Star us to get notified about new features and bugfixes ⭐️ ✨ Features 1 Analyze photos and invoices with AI Currency Conversion Snap a photo of any receipt or upload an invoice PDF, and TaxHacker will automatically recognize, extract, categorize, and store all the information in a structured database. Upload and organize your docs: Store multiple documents in "unsorted" until you're ready to process them manually or with AI assistance AI data extraction: Use AI to automatically pull key information like dates, amounts, vendors, and line items Auto-categorization: Transactions are automatically sorted into relevant categories based on their content Item splitting: Extract individual items from invoices and split them into separate transactions when needed Structured storage: Everything gets saved in an organized database for easy filtering and retrieval Choose your LLM: You can use OpenAI, Google Gemini, or Mistral or even your local LLM (in the self-hosted version). Only you're responsible for the quality and privacy of your data. TaxHacker works with a wide variety of documents, including store receipts, restaurant bills, invoices, bank statements, letters, even handwritten receipts. It handles any language and any currency with ease. 2 Multi-currency support with automatic conversion (even crypto!) Currency Conversion TaxHacker automatically detects currencies in your documents and converts them to your base currency using historical exchange rates. Foreight currency detection: Automatically identify the currency used in any document Historical rates: Get conversion rates from the actual transaction date All-world coverage: Support for 170+ world currencies and 14 popular cryptocurrencies (BTC, ETH, LTC, DOT, and more) Flexible input: Manual entry is always available when you need more control 3 Use your own LLM: Ollama, LM Studio, vLLM, LocalAI etc It's compatible with your local LLM OpenAI-compatible API endpoint. Just make sure that your local model is good in OCR tasks, results are not guaranteed :) Local LLMs 4 Organize your transactions using fully customizable categories, projects and fields Transactions Table Adapt TaxHacker to your unique needs with unlimited customization options. Create custom fields, projects, and categories that better suit your specific needs, idustry standards or country. Custom categories and projecst: Create your own categories and projects to group your transactions in any convenient way Custom fields: You can create unlimited number of custom fields to extraxt more information from your invoices (it's like creating extra columns in Excel) Full-text search: Search through the actual content of recognized documents Advanced filtering: Find exactly what you need with search and filter options AI-powered extraction: Write your own prompts to extract any custom information from documents Bulk operations: Process multiple documents or transactions at once 5 Customize any LLM prompt. Even system ones Custom Categories Take full control of how TaxHacker's AI processes your documents. Write custom AI prompts for fields, categories, and projects, or modify the built-in ones to match your specific needs. Customizable system prompts: Modify the general prompt template in settings to suit your business Field or project-specific prompts: Create custom extraction rules for your industry-specific documents Full control: Adjust field extraction priorities and naming conventions to match your workflow Industry optimization: Fine-tune the AI to understand your specific type of business documents Full transparency: Every aspect of the AI extraction process is under your control and can be changed right in settings TaxHacker is 100% adaptable and tunable to your unique requirements — whether you need to extract emails, addresses, project codes, or any other custom information from your documents. 6 Flexible data filtering and export Data Export Once your documents are processed, easily view, filter, and export your complete transaction history exactly how you need it. Advanced filtering: Filter by date ranges, categories, projects, amounts, and any custom fields Flexible exports: Export filtered transactions to CSV with all attached documents included Tax-ready reports: Generate comprehensive reports for your accountant or tax advisor Data portability: Download complete data archives to migrate to other services—your data stays yours 7 Self-hosted mode for data privacy Self-hosting Keep complete control over your financial data with local storage and self-hosting options. TaxHacker respects your privacy and gives you full ownership of your information. Home server ready: Host on your own infrastructure for maximum privacy and control Docker native: Simple setup with provided Docker containers and compose files Data ownership: Your financial documents never leaves your control No vendor lock-in: Export everything and migrate whenever you want Transparent operations: Full access to source code and complete operational transparency 🛳 Deployment and Self-hosting TaxHacker can be easily self-hosted on your own infrastructure for complete control over your data and application environment. We provide a [Docker image and Docker Compose setup that makes deployment simple: curl -O https://raw.githubusercontent.com/vas3k/TaxHacker/main/docker-compose.yml docker compose up The Docker Compose setup includes: TaxHacker application container PostgreSQL 17+ database (or connect to your existing database) Automatic database migrations on startup Volume mounts for persistent data storage Production-ready configuration New Docker images are automatically built and published with every release. You can use specific version tags (e.g., v1.0.0) or latest for the most recent version. For advanced setups, you can customize the Docker Compose configuration to fit your infrastructure. The default configuration uses the pre-built image from GitHub Container Registry, but you can also build locally using the provided Dockerfile. Example custom configuration: services: app: image: ghcr.io/vas3k/taxhacker:latest ports: "7331:7331" environment: SELF_HOSTED_MODE=true UPLOAD_PATH=/app/data/uploads DATABASE_URL=postgresql://postgres:postgres@localhost:5432/taxhacker volumes: ./data:/app/data restart: unless-stopped Environment Variables Configure TaxHacker for your specific needs with these environment variables: | Variable | Required | Description | Example | |----------|----------|-------------|---------| | UPLOAD_PATH | Yes | Local directory for file uploads and storage | ./data/uploads | | DATABASE_URL | Yes | PostgreSQL connection string | postgresql://user@localhost:5432/taxhacker | | PORT | No | Port to run the application on | 7331 (default) | | BASE_URL | No | Base URL for the application | http://localhost:7331 | | SELF_HOSTED_MODE | No | Set to "true" for self-hosting: enables auto-login, custom API keys, and additional features | true | | DISABLE_SIGNUP | No | Disable new user registration on your instance | false | | BETTER_AUTH_SECRET | Yes | Secret key for authentication (minimum 16 characters) | your-secure-random-key | ⌨️ Local Development We use: Next.js 15+ for the frontend and API Prisma for database models and migrations PostgreSQL as the database (PostgreSQL 17+ recommended) Ghostscript and GraphicsMagick for PDF processing (install on macOS via brew install gs graphicsmagick) Set up your local development environment: Clone the repository git clone https://github.com/vas3k/TaxHacker.git cd TaxHacker Install dependencies npm install Set up environment variables cp .env.example .env Edit .env with your configuration Make sure to set DATABASE_URL to your PostgreSQL connection string Example: postgresql://user@localhost:5432/taxhacker Initialize the database npx prisma generate && npx prisma migrate dev Start the development server npm run dev Visit http://localhost:7331 to see your local TaxHacker instance in action. For a production build, instead of npm run dev use the following commands: Build the application npm run build Start the production server npm run start 🤝 Contributing No AI-slop PRs. Please open a new Issue and discuss the details with maintainers before sending new changes. ❤️ Support the Project If TaxHacker has helped you save time or manage your finances better, consider supporting its development! Your donations help us maintain the project, add new features, and keep it free and open source. Every contribution helps ensure we can keep improving and maintaining this tool for the community: Thank the TaxHacker devs 📄 License TaxHacker is licensed under the MIT License.

Extracted system prompts from ChatGPT (GPT-5.4, GPT-5.3, Codex), Claude (Opus 4.6, Sonnet 4.6, Claude Code), Gemini (3.1 Pro, 3 Flash, CLI), Grok (4.2, 4), Perplexity, and more. Updated regularly.