NUMAN HAYDERSOFTWARE / SYSTEMS / TOOLS

ROOT / ACTIVE

SYSTEM ACTIVE

NUMANHAYDER

AI agents that do real work, developer tools, and Linux desktop software. Currently shipping Modu across Discord, Slack and WhatsApp.

NODES
07
LAB
06
SOURCE
GITHUB (opens in a new tab)

NUMAN.HAYDERROOT / BYTE4DAY

SYSTEM / SHIP LOG

Shipped lately

6 RELEASES / LAST 2026-10-11

  1. LATEST

    • NUMMODE

      nummode v2.0.0: the router

      • route.py detects the mission and ranks every installed skill
      • Slot tables per mission in the playbooks
    • QURANFLOW

      QuranFlow for Claude Code

      • One-call --brief mode: one command, one output line
      • 30-second teaser
    • LOST ISLAND

      Lost Island redesign

      • Pure black card, round switch grid, art-tinted player
      • Clipboard history, color picker, power menu
      • New screenshots and an 11-second demo
    • MODU

      Modu: help desk, incidents, bookings

      • Slack: response targets and /modu incident
      • WhatsApp: bookings, payment links, shared inbox
    • MODU

      Automations on Slack and WhatsApp

      • When-this-then-that rules on messages, joins and reactions
      • Member suggestions with voting
    • MODU

      Modu for Slack and WhatsApp go live

      • slack.ubits.tech and whatsapp.ubits.tech
      • Same assistant and approvals as Discord

SELECTED WORK / 07 NODES / NEWEST FIRST

PROJECT / 01

Modu

One AI operator for Discord, Slack and WhatsApp.

Modu runs Discord servers, Slack workspaces and WhatsApp numbers from plain-language requests. It plans every change, shows the risk, waits for an OK, applies it and keeps an undo. Built at UBITS Technologies.

  • NEXT.JS
  • TYPESCRIPT
  • POSTGRES
  • LLM AGENTS

REQUESTmake a staff-only support channel with tickets

  1. CREATE#support · staff-onlyLOW
  2. CREATEticket panel in #supportLOW
  3. UPDATE@Staff can manage threadsMED
FIG. 01 / PLAN, APPROVE, APPLY, UNDO / ILLUSTRATION OF THE FLOW
  • DISCORDServers

    • Channels, roles and permissions from chat
    • Automod, anti-raid, tickets and leveling
    • Daily backups and weekly health reports
  • SLACKWorkspaces

    • Help desk with response targets
    • /modu incident: channel, on-call, post-mortem
    • Async standups, polls and automations
  • WHATSAPPNumbers

    • Shop assistant on your real prices
    • Bookings, reminders and payment links
    • Shared team inbox and voice-note transcripts

MODU↔ AGENT WORKFLOWSNUMMODEQURANFLOWAYAHPATH

PROJECT / 02

nummode

Paste a big prompt. It routes the skills.

A routing layer for agent harnesses. Version 2 ships route.py: it reads a long brief, detects the mission, ranks every installed skill, and locks one to seven of them. Then it executes and verifies with real commands, without asking which skills to use.

  • PYTHON
  • SHELL
  • AGENT SKILLS

CLAUDE CODE / CURSOR / CODEX / ANTIGRAVITY

  1. 01INTAKEgoal, deliverables, constraints, stack
  2. 02MISSIONbuild, fix, design-ui, audit, research…
  3. 03ROUTEroute.py ranks installed skills, locks one to seven
  4. 04INVOKEload skills before real work
  5. 05EXECUTEparallel only when safe
  6. 06VERIFYevidence before done
you: [1200-word product brief]
nummode · build · skills: writing-plans, frontend-design,
        verification-before-completion
        → plans → builds → verifies → done
FIG. 02 / ANNOUNCE LINE / FROM THE README
ROUTING SCORE / KEEP ≥ 3
Description overlaps the prompt+2
Mission playbook lists the skill+2
Stack matches repo or prompt+1
Weak or generic match only−2
Duplicates a selected skill−3

PROJECT / 03

QuranFlow

Qur'an recitation while you code.

A small Linux CLI that streams a chosen Surah and reciter through mpv in the background. It works the same from a terminal, Claude Code, Cursor or Codex, and an agent call costs one command and one line of output.

  • PYTHON
  • MPV
  • CLI
  • AGENT SKILLS
TERMINAL
play-quran al-kahf --reciter dosari
CLAUDE CODE
/play-quran yasin
CODEX
$play-quran pause
CURSOR
/play-quran volume 60

AGENT OUTPUT / ONE LINEplaying · 036 Yaseen · Mishary Alafasi · vol 65

SOURCE / PRIVATE FOR NOW
FIG. 03 / 30-SECOND TEASER / SOUND DESIGN ONLY

QURANFLOW↔ QUR'ANMODUNUMMODELOST ISLANDAI USAGEAYAHPATH

PROJECT / 04

Lost Island for Archcraft Sway

A black dynamic island for Sway.

A customized Linux build of Marco Zorn's Lost Island, redesigned in pure black. The idle pill shows the Arch mark and clock; the expanded card holds a player tinted by the album art, a grid of round switches for Wi-Fi, Bluetooth and audio, a focus timer, screen recording and launchers for Claude Code, Codex and Cursor Agent. Media keys drive any MPRIS player.

FIG. 04 / 11-SECOND DEMO / RECORDED 2026-10-11
SWITCHES
Wi-Fi, Bluetooth, Sound, Mic. Blue means on; right-click opens settings
TOOLS
Focus (Do Not Disturb), Screen and Area shots, Color picker, Record, AirPlay
CLIPBOARD
Last 25 copies, kept in memory only, never written to disk
POWER
Lock, Log out, Sleep, Restart, Shut down; risky ones need a second click
PILL
Scroll for volume, middle-click to play or pause, swipe to change the face

REQUIRES

  • Sway on Wayland
  • Python 3.11+
  • GTK4 + libadwaita
  • gtk4-layer-shell
  • wf-recorder
  • hyprpicker
  • UxPlay (AirPlay)
  • PYTHON
  • GTK4
  • LAYER SHELL
  • WAYLAND

Based on Lost Island v1.7.2 (opens in a new tab) by Marco Zorn, MIT. Original attribution kept.

SOURCE (GitHub, opens in a new tab)

LOST ISLAND↔ LINUXQURANFLOWAI USAGE

PROJECT / 05

AI Usage

Usage limits, read from what is already on disk.

A GNOME Shell extension and a native Windows widget that show Cursor, Claude and Codex usage from local sessions. It reuses the credentials each CLI already stored, so there is no separate sign-in.

  • C++
  • JAVASCRIPT
  • GNOME SHELL
  • WIN32
AUTH / REUSED FROM EACH CLI
PROVIDERREADSFALLBACK
Cursor~/.config/cursor/auth.jsonCURSOR_SESSION_TOKEN, or desktop state.vscdb
Claude~/.claude/.credentials.jsonCLAUDE_CODE_OAUTH_TOKEN
Codex~/.codex/auth.jsonnone
PANEL RING / NEUTRAL BELOW 75%, AMBER PAST 75%, RED PAST 90%
GNOME
Top-panel extension for Shell 46–50. One line per provider, a thin bar per pool with its reset countdown.
WINDOWS
Floating Win32 card and tray icon, built with CMake and MSVC or MinGW.
TOKENS
Expired Claude tokens are renewed with the saved refresh token and written back, so the CLI stays signed in. If the file cannot be written, renewal is abandoned.

AI USAGE↔ LINUXNUMMODEQURANFLOWLOST ISLANDPXFORGE

PROJECT / 06

PxForge

Turn a codebase into context.

Walks a project, analyzes every file with an LLM, and writes one Markdown document: summary, directory tree, per-file breakdowns and a system prompt tailored to that code. Paste it once into Claude, ChatGPT, Gemini or Cursor.

  • PYTHON
  • TEXTUAL TUI
  • LLM
  • DEVTOOLS
  1. 01 SCANWalk the tree. Skip binaries, build output, lock files and anything in .gitignore.
  2. 02 ANALYZEEach file goes to the model for purpose, key functions, dependencies and odd logic.
  3. 03 MERGELarge files are chunked, analyzed in parts, then merged into one summary.
  4. 04 WRITEOne Markdown document: summary, tree, per-file notes and a ready system prompt.
SOURCE (GitHub, opens in a new tab)
OPEN DETAILSCLOSE DETAILS
PROVIDERS
OpenAI, Anthropic, Groq, OpenRouter, Ollama (local models detected automatically)
RUNS
Files analyzed concurrently with provider-aware rate limiting
OUTPUT
Token estimate, one-click open in an assistant, private Gist link for a team
INSTALL
python3 pxforge.py install writes ~/.local/bin/pxforge

PXFORGE↔ AI TOOLINGNUMMODEAI USAGE

PxForge terminal interface: settings screen with provider set to Anthropic, a model picker, Fast or High Quality mode, and preferred AI for viewing output.
FIG. 06 / SETTINGS SCREEN / TEXTUAL TUI

PROJECT / 07

AyahPath

Qur'anic guidance for the situation you are in.

Built for the Quran Hackathon. Pick a life situation such as stress, anger or patience and read related verses with translation, tafsir, recitation audio and connected hadith. Journaling and prayer tracking stay on the device.

  • FLASK
  • SQLITE
  • VANILLA JS
  • PWA
AyahPath home screen showing the ayah for today, Al-Anfal 8:2, in Arabic with an English translation, a streak counter and a list of life scenarios.
FIG. 07 / HOME / AYAH FOR TODAY, AL-ANFAL 8:2
TRANSLATIONS
Urdu, English, French, Indonesian, Bengali, Turkish, Hindi
ACCESSIBILITY
Protanopia, deuteranopia and tritanopia modes, high contrast, adjustable text size
OFFLINE
Bundled Qur'an data and local SQLite. Reflections stay in the browser

SYSTEM / INDEX

Index

00 / 07

SYSTEM / LAB

Lab

Smaller public repositories: experiments, skills, a spec and a bot.

IDREPOSITORYDESCRIPTIONKINDLANGUPDATEDSource
L-06WhiteBoardDesktop drawing board: pen, shapes, text, zoom and pan, undo, PNG export.DESKTOP APPPYTHON / TKINTERSOURCE WhiteBoard on GitHub (opens in a new tab)
L-07NezoPerWhatsApp assistant with per-chat memory, adaptive reply style and natural-language actions.BOTNODE.JS / BAILEYSSOURCE NezoPer on GitHub (opens in a new tab)
L-08bite-watchAgent skill that picks one thing to watch while you eat and opens it.AGENT SKILLMARKDOWNSOURCE bite-watch on GitHub (opens in a new tab)
L-09Claude-makeup-skillClaude skill that interviews first, researches current products, then recommends shades and routines.AGENT SKILLMARKDOWNSOURCE Claude-makeup-skill on GitHub (opens in a new tab)
L-10byte4day-ai-ideaDesign spec for a voice-first personal AI layer: orchestrator, memory, agents, consent.SPECMARKDOWNSOURCE byte4day-ai-idea on GitHub (opens in a new tab)
L-11byte4dayGitHub profile README.PROFILEPYTHONSOURCE byte4day on GitHub (opens in a new tab)

SYSTEM / ABOUT

About

Numan builds software across developer tooling, applied AI, full-stack web applications, Linux desktop systems, automation and security. Most of it starts as a tool he needed himself.

WORKING AREAS

  • Developer tools
  • Applied AI
  • Linux desktop
  • Full-stack
  • Automation
  • Security

TECH / SIGNAL / WHERE

  • TYPESCRIPT / NEXT.JSPRODUCTS / CONSOLESModu, numan.fun
  • PYTHONTOOLING / DESKTOP / CLISnummode, QuranFlow, PxForge, Lost Island, AyahPath
  • JAVASCRIPTWEB / GNOME SHELL / BOTSAI Usage, AyahPath, NezoPer
  • C++NATIVE WINDOWS WIDGETAI Usage
  • FLASK + SQLITEAPPLICATIONSAyahPath
  • GTK4 / TEXTUAL / TKINTERINTERFACESLost Island, PxForge, WhiteBoard
  • POSTGRESPRODUCT DATAModu
  • LINUXSYSTEM ENVIRONMENTLost Island, QuranFlow, AI Usage
  • SHELL / GITINSTALLERS / WORKFLOWnummode, PxForge