NUMAN HAYDERSOFTWARE / SYSTEMS / TOOLS

ROOT / ACTIVE

SYSTEM ACTIVE

NUMANHAYDER

Developer tools, Linux desktop software and AI-assisted workflows. Full-stack apps when the problem needs one.

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

NUMAN.HAYDERROOT / BYTE4DAY

SELECTED WORK / 05 NODES

PROJECT / 01

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. 01 / SETTINGS SCREEN / TEXTUAL TUI

PROJECT / 02

nummode

Paste a big prompt. It routes the skills.

A routing layer for agent harnesses. It reads a long brief, picks a mission, scores the installed skills, locks a plan of three to seven, then executes and verifies 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. 03ROUTEscore installed skills, lock three 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
SOURCE (GitHub, opens in a new tab)

NUMMODE↔ AGENT WORKFLOWSPXFORGEAI USAGE

PROJECT / 03

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. 03 / 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
SOURCE (GitHub, opens in a new tab)

AYAHPATH↔ FULL-STACK

PROJECT / 04

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
SOURCE (GitHub, opens in a new tab)
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↔ LINUXPXFORGENUMMODELOST ISLAND

PROJECT / 05

Lost Island for Archcraft Sway

A black dynamic island for Sway.

A customized Linux build of Marco Zorn's Lost Island. The idle pill shows the Arch mark and clock; the expanded card holds music, Wi-Fi, Bluetooth and audio switches, an AirPlay receiver, a focus timer, screen recording and launchers for Claude Code, Codex and Cursor Agent.

FIG. 05 / 27-SECOND DEMO FROM THE REPOSITORY

LOST ISLAND↔ LINUXAI USAGE

SYSTEM / INDEX

Index

00 / 05

  1. PXFORGE, devtools, jump to projectOPEN PxForge on GitHub (opens in a new tab)
  2. NUMMODE, agents, jump to projectOPEN nummode on GitHub (opens in a new tab)
  3. AYAHPATH, web, jump to projectOPEN AyahPath on GitHub (opens in a new tab)
  4. AI USAGE, system, jump to projectOPEN AI Usage on GitHub (opens in a new tab)
  5. LOST ISLAND, linux, jump to projectOPEN Lost Island for Archcraft Sway on GitHub (opens in a new tab)

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

  • PYTHONTOOLING / DESKTOP / APISPxForge, Lost Island, AyahPath, WhiteBoard
  • JAVASCRIPTWEB / GNOME SHELL / BOTSAI Usage, AyahPath, NezoPer
  • C++NATIVE WINDOWS WIDGETAI Usage
  • FLASK + SQLITEAPPLICATIONSAyahPath
  • GTK4 / TEXTUAL / TKINTERINTERFACESLost Island, PxForge, WhiteBoard
  • LINUXSYSTEM ENVIRONMENTLost Island, AI Usage
  • SHELL / GITINSTALLERS / WORKFLOWnummode, PxForge