imlazy — Token-Efficient Tier-Routed Agent Orchestrator

imlazy

Token-efficient tier-routed agent orchestrator
40+ skills, 19 agents, Obsidian vault

imlazy version 1.0.0 MIT License Pull Requests welcome Shell Python JavaScript TypeScript Obsidian

How It Works

imlazy classifies every AI coding task by complexity and routes it to the appropriate workflow tier. Each tier loads only the skills it needs, saving tokens on simple tasks while keeping full rigor for complex ones.

Quick
~1.5K tokens

Single-file edit, typo fix, version bump, config change, factual question — inline execution with verification gate

Standard
~14.5K tokens

Multi-file feature or bugfix with clear requirements — light planning, test-driven development, code review

Heavy
~17K tokens

New subsystem, ambiguous scope, architectural design — brainstorming, full planning with subagents, TDD, code review

Vault
Persistent

Knowledge persistence across sessions — initialize vault, save context, search notes, link knowledge

Features

What makes imlazy different from other agent workflows.

🎯

Tiered Routing

Tasks classified by complexity into Quick, Standard, Heavy, or Vault tiers. Each tier loads only the skills it needs. Simple edits cost approximately 1.5K tokens instead of 14K.

📦

40+ Workflow Skills

Pre-built skills for planning, test-driven development, code review, brainstorming, debugging, API design, frontend and backend development, security review, WordPress with ACF, coding standards, and more.

🤖

19 Subagent Prompts

Specialized agents for planning, architecture, code review, security review, TDD coaching, build fixing, end-to-end testing, documentation, refactoring, database design, and language-specific reviewers for Python, Go, Rust, Java, C++, Kotlin, and PHP.

🏛️

Obsidian Vault Integration

Persistent knowledge across sessions using Obsidian Flavored Markdown, structured Bases records, JSON Canvas diagrams, CLI vault interaction, and clean web page extraction via Defuddle.

🪶

Token-Budgeted Design

Every skill file stays within a strict word budget. The router loads only what the tier requires — no wasted context, no unnecessary overhead on simple tasks.

🔗

Cross-Harness Support

Works with Claude Code, OpenCode, and Codex CLI. Self-contained with zero external plugin dependencies — clone the repo and run the install script.

Quick Start

Install imlazy and start using it in under a minute.

Clone and Install
git clone https://github.com/hnikoloski/imlazy.git
cd imlazy

# macOS, Linux, WSL
bash install.sh

# Windows PowerShell
.\install.ps1
Verify Installation
# Unix / WSL
bash tests/run.sh

# Any platform with Python 3
python tests/run-tests.py
Usage Examples
/imlazy fix the typo on line 5 of README.md
i am lazy, add a /health endpoint that returns {status: ok}
i am lazy, vault init
/imlazy design the database schema for user subscriptions

Included Skills

Every skill is a focused SKILL.md file with clear instructions and token budgets. Skills are loaded lazily by the router based on task tier.

imlazy-router — Tier classification and dispatch
imlazy-bootstrap — Session entry point and trigger detection
imlazy-planning — Implementation plans (light and full modes)
imlazy-tdd — Test-driven development with completion gate
imlazy-code-review — Code review request and receive workflow
imlazy-brainstorm — Requirements gathering and specification
imlazy-debug — Root-cause investigation workflow
imlazy-parallel — Cache-friendly parallel agent dispatch
imlazy-worktrees — Isolated workspace management
imlazy-learn — Router misclassification logging and adaptation
imlazy-vault — Knowledge persistence and retrieval
imlazy-wordpress — WordPress and ACF development
imlazy-security — Security review patterns
imlazy-api-design — REST API design patterns
imlazy-frontend — Frontend development (React, TypeScript)
imlazy-backend — Backend architecture patterns
imlazy-standards — Cross-project coding conventions
imlazy-verify — Pre-completion verification workflow

Cross-Harness Support

imlazy works with every major AI coding assistant harness without modification.

HarnessConfig FileInstall Method
Claude Code (Anthropic).claude-plugin/plugin.jsoninstall.sh auto-detects or --target claude
OpenCodeopencode.jsoncAlready in-repo — run opencode load
Codex CLI (OpenAI).codex-plugin/codex.mdinstall.sh --target codex

License

Open source and free forever.

imlazy is released under the MIT License. Use it, modify it, distribute it — no restrictions. See ATTRIBUTIONS.md for third-party acknowledgments.