⚡ TidyFactor

# Launch the TidyFactor Control Plane across your project
npx @tidyfactor/cli init
# Or install globally to activate the short 'tf' control plane alias
npm install -g @tidyfactor/cli
tf init

# Run any engine ephemerally without installing (stream prompt or launch agent)
tf use design "Build a luxury dark hero section" | claude

• 🏛️ Executive Manifesto: The Operating System for AI-Assisted Software Production
• 🧩 The 6-Layer Architecture of TidyFactor OS
  • Layer 1: Cognitive Memory & Governance Kernel (tidyfactor-brain)
  • Layer 2: Developer Control Plane (tf CLI Engine)
  • Layer 3: The Architectural Governance Layer (tidyfactor-skill-architect)
  • Layer 4: The 13 Modular Domain Capability Engines
  • Layer 5: The Agent Interoperability Fabric (18+ IDEs)
  • Layer 6: Sovereign Multi-Tenant BaaS & Enterprise Cloud
• ⚡ Quick Multi-Platform Installation (Zero-Lockin)
  • 1. Universal Node.js Control Plane (npx & global tf)
  • 2. Standalone Linux & macOS POSIX Oneliner
  • 3. Standalone Windows PowerShell Oneliner
  • 4. macOS & Linux Homebrew Formula
• 🕹️ Control Plane Keyboard Shortcuts (Interactive TUI)
• 📋 Complete Control Plane Command Reference (tf)
  • 1. tf init (Project Environment Discovery & Context Binding)
  • 2. tf add <engine|pack> (Targeted Capability Mounting & Canonical Junctions)
  • 3. tf use <engine> [prompt] (Ephemeral Execution Without Installing)
  • 4. tf find [query] (Instant Smart Discovery Engine)
  • 5. tf sync (Live Active Agent Synchronization)
  • 6. tf outdated & tf update (Lifecycle Drift & Upgrades)
  • 7. tf remove <engine> (Safe Capability Unmounting)
  • 8. tf info <engine> (Architecture Inspection & Triggers)
  • 9. tf doctor (Comprehensive Workspace Health Audit)
  • 10. tf whoami (Sovereign Cloud Identity & Memory Diagnostics)
  • 11. tf packs & tf list (Engine & Catalog Inspection)
  • 12. tf pro (Enterprise DevOps & PocketOffice Gateway)
• 📦 Curated Production Workflow Packs (5 Core Suites)
• 🏛️ The 13 Modular Domain Capability Engines
• 🤖 The Agent Interoperability Fabric (18+ IDEs)
• 🛡️ Governance Lockfile Specification (.tidyfactor/skills.lock)
• 💼 Enterprise Pro Ecosystem & Alwkala Product Foundry
• ❓ Frequently Asked Questions (FAQ)
• 👨‍💻 Organization & Official Channels
• 📜 License

Artificial Intelligence did not simply make software development faster. It fundamentally transformed how software is conceptualized, authored, governed, and maintained.

Raw, unconstrained LLM code generation inevitably leads to Architectural Degradation:

• Disposable Code vs. Sustainable Systems: AI produces rapid one-off code blocks that ignore project conventions, creating unmaintainable technical debt.
• Prompt Drift & Context Amnesia: LLMs lack continuous memory across sessions, re-inventing basic patterns and forgetting architectural boundaries.
• The "AI Slop" Trap: Unvetted generic color palettes, broken directional CSS margins (mr-*, ml-* breaking RTL), and missing interactive states.
• Siloed Agent Toolchains: Cursor, Claude Code, Antigravity, Windsurf, and Copilot operate in isolated silos with inconsistent rules and duplicated configs.

TidyFactor is the Operating System designed for this new reality. Just as Unix standardized processes, memory spaces, file descriptors, and a unified shell for computing, TidyFactor standardizes cognitive memory, architectural contracts, anti-slop quality gates, and a unified Control Plane (tf) for AI-assisted software production.

graph TD
    subgraph Layer6 ["Layer 6: Sovereign BaaS & Enterprise Cloud"]
        CloudDB[Sovereign Dedicated SQLite/Postgres DB]
        BaaSAPI[MCP Stdio/HTTP Cognitive Microservices]
        ProPacks[Enterprise DevOps & PocketOffice Pro Packs]
    end

    subgraph Layer5 ["Layer 5: Multi-Agent Interoperability Fabric (18+ IDEs)"]
        Antigravity[Google Antigravity]
        Cursor[Cursor IDE]
        Windsurf[Windsurf Cascade]
        Claude[Claude Code]
        Trae[Trae AI]
        OtherAgents[Copilot, RooCode, Codex, KiloCode, Warp, Zed...]
    end

    subgraph Layer4 ["Layer 4: Modular Domain Capability Engines (13 Core Tracks)"]
        GovEngines["Governance: Skill-Architect, Brain, GitHub"]
        DesignEngines["Visual/UX: Cinematic, Design, Styler"]
        CoreRuntimes["Core Runtimes: Next.js, PHP Monolith, HTMX, Vanilla JS, Static HTML"]
        DocGrowth["Knowledge: Doc Platform, Marketing & SEO"]
    end

    subgraph Layer3 ["Layer 3: Architectural Governance & Quality Gates"]
        CDL[Contextual Decision Layer CDL v2.0]
        QualityGates[50+ Anti-Slop Matrix & 7-Axis Critique P/H/E/S/R/V/D]
        RuleCatalogs[Prioritized Rule Catalogs & SSOT Contracts]
    end

    subgraph Layer2 ["Layer 2: Developer Control Plane (tf CLI Engine)"]
        CLIControl["⚡ TidyFactor CLI Engine (tf / tidyfactor)"]
        TUI[Zero-Dep Interactive RawMode TUI]
        Lockfile[Governance Lockfile .tidyfactor/skills.lock]
        SyncEngine[Active Agent Auto-Discovery & Sync]
    end

    subgraph Layer1 ["Layer 1: Cognitive Memory & State Kernel"]
        MemoryOS[4-Tier Knowledge Taxonomy: Global / Tech / Project / Session]
        Firewall[Contextual Firewall: Dev Mode vs. Marketing Mode]
        VSS[Gemini Context Caching & Vector Memory Retrieval]
    end

    Layer1 --> Layer2
    Layer2 --> Layer3
    Layer3 --> Layer4
    Layer4 --> Layer5
    Layer5 --> Layer6

The kernel of the OS. It manages persistent state across agent interactions using a 4-Tier Knowledge Taxonomy:

• Tier 1 (Global): Universal engineering truths, invariant architectural axioms, and cross-project heuristics.
• Tier 2 (Tech): Stack-specific operational memory (Next.js 16 RSC boundaries, PHP 8 modular hooks, HTMX swap invariants).
• Tier 3 (Project): Local workspace briefs (.tidyfactor/*-brief.md), design tokens (brand.yaml), and project constraints.
• Tier 4 (Session): Ephemeral working memory, scratchpads, and active problem-solving traces.
• Contextual Firewall: Strict partition preventing cross-domain context bleed (e.g. keeping backend database security out of marketing copy tasks).

The developer's cockpit. Far more than a package installer, the Control Plane executes:

• Environment Telemetry: Instant AST inspection of package manifests, framework dependencies, and IDE signatures.
• Interactive TUI: Arrow-key navigation, live fuzzy search, and spacebar multi-select with zero external dependencies.
• Lockfile State Governance: Writes and verifies .tidyfactor/skills.lock to maintain strict project reproducibility.
• Multi-Agent Mounting & Sync: Detects active agent directories and syncs capabilities across all of them in a single keystroke.
• Health Diagnostics (tf doctor) & Identity Observability (tf whoami): Full inspection of runtime readiness and cloud brain connectivity.

The constitution of the operating system:

• Contextual Decision Layer (CDL v2.0): Thin arbitration protocol resolving unknowns via single-round batching and safe defaults.
• Anti-Slop Quality Gate Matrix: 50+ categorical binary prohibitions banning AI tropes (generic purple gradients, unstated low-contrast grays, arbitrary margins).
• 7-Axis Pre-Emit Critique Stamps: Evaluates all code before delivery across Performance (P), Hygiene (H), Elegance (E), Security (S), RTL/i18n (R), Visual Rigor (V), and Decision Alignment (D).

Thirteen self-contained, deterministic capability tracks covering the full software production lifecycle:

1. tidyfactor-skill-architect — Master Governance Layer & Methodology Engine.
2. tidyfactor-brain — Cognitive OS, 4-Tier Memory Governance & Native Stdio MCP Server.
3. tidyfactor-github — GitHub Platform Operations, Rulesets, SHA-pinned Actions CI & CX Intelligence.
4. tidyfactor-cinematic — Luxury Scroll-Driven Landing Pages (Apple x Cartier aesthetic) & Canvas Sequences.
5. tidyfactor-design — Code-Native Interactive Prototyping & Figma Alternative for Design Systems with CDL.
6. tidyfactor-styler — Production Framework Styler & Surgical RTL Polish Engine (Next.js, PHP, Vanilla).
7. tidyfactor-next — Multi-Tenant SaaS Engine on Next.js 16, React 19, TypeScript strict, and Supabase RLS.
8. tidyfactor-php — Modern Server-Rendered PHP 8.x Modular Monolith (Flight + Medoo + Plates) with RBAC.
9. tidyfactor-htmx — Server-Driven Hypermedia Interactivity Engine paired with PHP, Node, or Python.
10. tidyfactor-js — Framework-Free Reactive Vanilla SPA with client routing and Proxy state.
11. tidyfactor-html — 100% Static HTML5 Platform Starter with Web Components and zero server runtime.
12. tidyfactor-doc — Codebase Documentation Builder & Dual-Engine Publishing (MkDocs Material & Docsify).
13. tidyfactor-marketing — AI Direct-Response Marketing, Pillar-Cluster SEO & Multi-Channel Growth Engine.

Eliminates proprietary vendor lock-in. A single command equips any IDE: Google Antigravity, Cursor, Windsurf, Trae, Claude Code, GitHub Copilot, RooCode, OpenCode, KiloCode, Warp, Kiro, Zed, JetBrains AI, Blackbox, Cline, AMP, OpenClaw, and Codex.

A secure cloud companion providing:

• Dedicated, private SQLite/PostgreSQL databases per tenant with zero cross-tenant leakage.
• Production MCP services over standard Stdio JSON-RPC 2.0 and HTTP.
• Enterprise DevOps (13 skills) and PocketOffice business automation suites (11 skills).

Requires standard Node.js (>= 16.0.0). Built with zero external dependencies for instant execution:

# Instant interactive control plane (NPX)
npx @tidyfactor/cli init

# Arabic language interface
npx @tidyfactor/cli init --ar

# Install globally to activate the fast 'tf' command alias
npm install -g @tidyfactor/cli

# Control plane daily workflows
tf init                         # Launch interactive setup & stack detection
tf add pack:design              # Mount curated design triad suite
tf add design --cursor          # Mount design studio specifically into Cursor
tf add brain --all-agents       # Mount cognitive memory across ALL active agents
tf sync                         # Re-synchronize capabilities across all active IDEs
tf outdated                     # Audit installed capabilities for version drift
tf update                       # Upgrade outdated engines while preserving local configs
tf doctor                       # Run comprehensive workspace diagnostics
tf whoami                       # Inspect sovereign cloud tenant quota & firewall state

For cloud CI/CD pipelines, Docker containers, and servers without Node.js:

# Interactive terminal setup
curl -fsSL https://tidyfactor.com/api/v1/install.sh | bash

# Non-interactive capability mounting
curl -fsSL https://tidyfactor.com/api/v1/install.sh | bash -s -- pack:design
curl -fsSL https://tidyfactor.com/api/v1/install.sh | bash -s -- pack:saas
curl -fsSL https://tidyfactor.com/api/v1/install.sh | bash -s -- tidyfactor-design
curl -fsSL https://tidyfactor.com/api/v1/install.sh | bash -s -- all

Pure ASCII oneliner compatible with Windows PowerShell 5.1 and PowerShell 7+:

# Interactive wizard in PowerShell
irm https://tidyfactor.com/api/v1/install.ps1 | iex

# Automated capability mounting
$Skill = 'pack:design'; irm https://tidyfactor.com/api/v1/install.ps1 | iex
$Skill = 'pack:saas'; irm https://tidyfactor.com/api/v1/install.ps1 | iex
$Skill = 'tidyfactor-design'; irm https://tidyfactor.com/api/v1/install.ps1 | iex
$Skill = 'all'; irm https://tidyfactor.com/api/v1/install.ps1 | iex

# Install directly from the official master repository:
brew install https://raw.githubusercontent.com/TidyFactor/TidyFactor/main/Formula/tidyfactor.rb

# Or tap the master repository:
brew tap TidyFactor/tidyfactor https://github.com/TidyFactor/TidyFactor.git
brew install tidyfactor

When operating interactively (tf init, tf add), the Control Plane activates its native Node.js raw-mode keyboard engine:

Launches the 3-step interactive onboarding process:

• Step 1: Environment & Agent Telemetry: Inspects AST packages (package.json, composer.json, mkdocs.yml, .git) and detects active coding agents.
• Step 2: Target Agent Mounting Matrix: Selects target agent directories (.agents, .cursor, .windsurf, .trae, .claude, etc.).
• Step 3: Track Selection: Matches project stack to recommended engines, curated suites, or custom selections.

tf init              # Standard English interactive wizard
tf init --ar         # Native Arabic interactive wizard
tf init -y           # Non-interactive silent installation with recommended defaults
tf init --dry-run    # Preview targets and engines without modifying disk

Installs a specific engine, curated workflow pack, or the entire 13-engine community suite into chosen agent directories.

# Mount by engine slug
tf add design
tf add tidyfactor-styler
tf add @tidyfactor/brain

# Target specific agent IDE directories
tf add design --cursor                     # Mount to .cursor/skills/
tf add cinematic --windsurf                # Mount to .windsurf/skills/
tf add styler --trae                       # Mount to .trae/skills/
tf add next --copilot                      # Mount to .github/prompts/
tf add skill-architect --global            # Mount globally (~/.gemini/config/skills/)
tf add brain --all-agents                  # Mount to ALL 18+ detected agent platforms

# Mount via specific agent flag (-a, --agent)
tf add design --agent claude-code

# Force deep file copy instead of symlink/junction
tf add design --all-agents --copy

# Mount curated workflow packs
tf add pack:design                         # Design & Frontend Triad
tf add pack:saas                           # SaaS Starter Kit
tf add pack:engineering                    # Full-Stack Engineering

# Mount entire 13-engine master suite
tf add --all

Executes any skill on-demand without writing permanent files to your repository or altering agent configurations. Perfect for quick one-off tasks, pipeline automation, or clipboard integration.

• Stdout Streaming: Without --agent, tf use streams the clean, fully-formatted markdown prompt directly to stdout with zero decorative ANSI noise, enabling effortless shell pipe composition.
• Interactive Agent Launch: With --agent <name>, tf use launches the target AI coding agent interactively with the generated prompt loaded.

# Stream prompt directly into Claude Code
tf use design "Build a luxury dark hero section" | claude

# Stream prompt into clipboard (Windows clip.exe / macOS pbcopy / Linux xclip)
tf use cinematic "Create scroll animation" | clip.exe
tf use cinematic "Create scroll animation" | pbcopy

# Launch an agent interactively with the skill prompt loaded
tf use design --agent claude-code
tf use styler "Polish RTL Arabic layout" --agent cursor

# Ephemeral execution with Arabic prompt assistance
tf use design "صمم واجهة هبوط داكنة فاخرة" --ar

Instantly searches the TidyFactor ecosystem across all 13 community skills, 5 curated workflow packs, and Pro enterprise suites by keyword, category, or semantic capability.

# Search by keyword
tf find rtl
tf find database
tf find saas

# Search with Arabic query or results
tf find "واجهة" --ar
tf find "ذاكرة" --ar

# Interactive search mode (prompts for keywords if none provided)
tf find

Scans your workspace for all detected AI coding agent directories (.cursor, .windsurf, .trae, .agents, etc.) and automatically synchronizes all currently installed engines into every active agent environment using canonical junctions.

tf sync              # Synchronize across all active agent workspaces
tf sync --ar         # Execute synchronization with Arabic logging
tf sync --copy       # Synchronize using physical file copies instead of junctions

Audits installed capability engines against official releases without checking GitHub or NPM manually:

# Compare installed versions against the official registry
tf outdated

# Upgrade a specific engine to its latest release
tf update design

# Upgrade all installed engines simultaneously
tf update

Sample output of tf outdated:

╭─────────────────────────────┬─────────────┬─────────────┬───────────────────╮
│ Skill                       │ Installed   │ Latest      │ Status            │
├─────────────────────────────┼─────────────┼─────────────┼───────────────────┤
│ tidyfactor-design           │ 1.8.0       │ 1.10.0      │ ⚡ Update Avail.  │
│ tidyfactor-brain            │ 3.0.0       │ 3.0.0       │ ✔ Up to date      │
│ tidyfactor-skill-architect  │ 2.6.0       │ 2.6.0       │ ✔ Up to date      │
╰─────────────────────────────┴─────────────┴─────────────┴───────────────────╯

Safely deletes an engine from all target agent directories and removes its entry from .tidyfactor/skills.lock:

tf remove html
tf remove tidyfactor-htmx

Displays detailed technical specifications, operational memory architecture, category, description, and slash commands for any engine:

tf info design
tf info brain

Performs a deep diagnostic audit of the local environment:

• Node.js runtime version and host platform.
• Workspace root directory.
• Detected frameworks and architectural stack.
• Active agent IDE signatures.
• Lockfile status (.tidyfactor/skills.lock).
• Registry endpoint health.

tf doctor
tf doctor --ar

Connects to the TidyFactor Sovereign Cloud Brain via Stdio/HTTP MCP and retrieves tenant quota, vector memory item count, and Contextual Firewall state ([Dev Mode] vs [Marketing Mode]). Falls back to Local Sovereign Mode if offline.

tf whoami

Lists all official community engines and workflow packs:

tf list              # Formatted ASCII table of all 13 engines
tf list --json       # Machine-readable JSON array for CI/CD
tf packs             # Catalog of 5 curated workflow packs
tf packs --json      # Machine-readable JSON catalog

Displays information on enterprise DevOps infrastructure engines (13 tracks) and PocketOffice business automation engines (11 tracks), with instructions on license activation:

tf pro

Every community engine is open-source (Apache-2.0), self-contained, and follows the 3-Tier Installation Standard:

💡 Mount Full Master Suite (All 13 Engines): tf add --all
(For air-gapped or offline enterprise environments without Node.js, standalone .skill binaries remain accessible via GitHub Releases).

The Control Plane automatically discovers and mounts capability engines into the correct project directories for all mainstream agent environments:

To guarantee reproducible human-agent collaboration and prevent undocumented prompt drift, TidyFactor OS codifies the Skill Lockfile Standard:

{
  "lockfile_version": "1.0.0",
  "generator": "@tidyfactor/cli@2.0.0",
  "updated_at": "2026-09-05T14:30:00.000Z",
  "skills": {
    "tidyfactor-design": {
      "version": "1.10.0",
      "source": "local",
      "installed_at": "2026-09-05T14:30:00.000Z",
      "targets": [
        ".agents/skills/tidyfactor-design",
        ".cursor/skills/tidyfactor-design"
      ]
    },
    "tidyfactor-brain": {
      "version": "3.0.0",
      "source": "cdn",
      "installed_at": "2026-09-05T14:30:00.000Z",
      "targets": [
        ".agents/skills/tidyfactor-brain"
      ]
    }
  }
}

1. Zip Slip Prevention: Every entry path in extracted archives is strictly checked to ensure it cannot resolve outside the intended target folder.
2. Atomic Staging Swapping: Extraction uncompresses into an isolated temporary folder (os.tmpdir()/tf_stage_*), validates the existence of SKILL.md, and only moves files to the final destination upon 100% verification.
3. Fail-Open Workstation Fallback: If network connectivity to NPM or CDN is interrupted, the Control Plane automatically falls back to local fast-sync or offline cache without blocking the developer.

TidyFactor maintains a strict separation between Open Architecture Standards and Commercial Implementations:

• Pure Intelligence & Context Layer Doctrine: TidyFactor is strictly the neutral Operating System (Kernel + Memory + Governance + Control Plane + Open Community Engines).
• Alwkala (الوكالة): Operates as the regional digital agency and product foundry building client implementations, web platforms, and templates powered by TidyFactor.
• Enterprise Pro Suites (tf pro):
  • DevOps Pro (13 Skills): ops-cpanel, ops-lamp, ops-cicd, ops-docker, ops-security, ops-db, ops-dns, ops-dr, ops-local-dev, ops-mail, ops-node, ops-testing, ops-wp.
  • PocketOffice Pro (11 Skills): pocket-crm, pocket-invoicing, pocket-finance, pocket-proposals, pocket-calendar, pocket-marketing, pocket-kb-manager, pocket-memory, pocket-module-builder, pocket-release.
  • MENA Growth Pro: tidyfactor-seo, mena-proposal-writer, website-copywriting-mena.

• 🌐 Official Website: https://tidyfactor.com/
• 📚 Documentation Platform: https://tidyfactor.com/documentation
• 🤝 Product Foundry & Partner: Alwkala Digital Agency (الوكالة)
• 🐙 GitHub Organization: github.com/TidyFactor
• 📦 NPM Registry: @tidyfactor/cli on NPM
• 📧 Business Inquiries: hello@tidyfactor.com
• 📱 WhatsApp: +20 101 665 6899
• 📍 Location: Cairo, Egypt 🇪🇬

Distributed under the Apache License 2.0. Copyright (c) 2026 TidyFactor & Alwkala Digital Agency.