GitHub
Yousaf's avatar
text-3xl text-zinc-950 font-medium

Yousaf

Building full-stack AI tools and Unix systems.

Overview

Lahore, Punjab, Pakistan

he/him

Social Links

About

Hey, I'm Muhammad Yousaf — a full-stack developer building practical AI applications and exploring systems programming.

My recent projects include DocsAI, which answers questions about legal PDFs with cited passages; Vidly, which analyzes YouTube comments and transcripts; and AutoHunt, which helps review and automate job applications. I build their interfaces and APIs with Next.js, React, TypeScript, Node.js, and Python FastAPI, and use LangGraph to coordinate AI workflows. PostgreSQL, Redis, and Qdrant support the data, queues, and search behind them.

I also built myShell, a Unix-like command shell in C++20. Working through parsing, pipelines, signals, and job control has sharpened how I think about processes and the tools my applications run on.

I enjoy taking a project from a responsive interface to the backend and the underlying workflow. If you're building something interesting in AI, web development, or developer tooling, I'd love to hear about it.

GitHub Contributions

Stack

Experience

Mozzine Technologies

Worked on-site as a Junior Frontend Developer, contributing to real-world web projects and collaborating with a cross-functional team.

Key Contributions:

  • UI Development: Developed and maintained user interfaces with a focus on performance, responsiveness, and cross-browser compatibility
  • Responsive Design: Implemented responsive web designs ensuring seamless experience across desktop, tablet, and mobile devices
  • Website Functionality: Improved existing website functionality and resolved UI/UX bugs to enhance overall user experience
  • Backend Collaboration: Worked closely with backend developers to integrate APIs and ensure smooth data flow across digital platforms
  • Professional Standards: Consistently upheld high professional standards and maintained a cooperative attitude within the team
  • Frontend Development
  • Responsive Design
  • HTML
  • CSS
  • JavaScript
  • API Integration
  • Cross-browser Compatibility
  • UI/UX
  • Teamwork
  • Problem-solving

Code Expert

Hiba Logics

Projects(4)

A Unix-like command shell built from scratch in C++20 to explore how real shells parse commands manage processes control terminals and coordinate Unix resources. It supports external programs concurrent pipelines redirections environment expansion aliases shell functions command history and foreground or background jobs through an interactive terminal interface.

Key Technical Achievements:

  • Quote-Aware Command Parser: Built a dedicated parser for single and double quotes backslash escaping environment assignments parameter expansion and syntax validation while correctly distinguishing quoted pipeline and background operators from shell control syntax
  • Concurrent Pipeline Execution: Implemented multi-stage pipelines with one child process per stage shared process groups correct file-descriptor wiring and final-stage exit status propagation
  • Foreground and Background Job Control: Added process-group based job management with terminal handoff background execution and the jobs fg and bg built-ins while preventing zombie processes through background reaping
  • Signal-Safe Interactive Behavior: Coordinated Ctrl+C Ctrl+\ and Ctrl+Z handling so signals reach foreground jobs without terminating the shell and prompt editing remains responsive
  • Transactional Redirection Engine: Supported input output append descriptor duplication and descriptor closure with left-to-right shell semantics plus automatic restoration of parent file descriptors after built-ins complete
  • Command Resolution Cache: Created PATH-based executable lookup with reusable path caching hit tracking invalidation when PATH changes and inspection through hash and type built-ins
  • Extensible Shell Features: Developed a built-in registry aliases simple single-line functions recursion protection persistent environment assignments and session history with arrow-key navigation
  • Pseudo-Terminal Integration Testing: Built automated CTest coverage for parsing execution exit statuses signals process groups terminal ownership and interactive job control using pseudo-terminals

Technical Architecture:

  • Runtime: C++20 application using POSIX process signal file-descriptor and terminal APIs
  • Parsing: Two-stage pipeline and command parser producing structured commands before execution begins
  • Execution: Parent-side dispatch for stateful built-ins plus fork and exec process groups for external commands pipelines and background jobs
  • Terminal Control: termios-based line editing process-group management and explicit terminal ownership handoff
  • Build and Testing: CMake with compiler warnings CTest unit tests and pseudo-terminal integration tests
  • C++20
  • CMake
  • POSIX APIs
  • Unix Process Management
  • Command Parsing
  • File Descriptor Management
  • Signal Handling
  • Job Control
  • CTest
  • Pseudo-Terminals

Inside the Build

Follow a task through the system, one stage at a time.

myShell: the life of a pipeline

From a line of text to two processes, a shared pipe, and a prompt that returns.

C++20POSIX6 stages

Read the walkthrough →

DocsAI: from PDF to cited answer

Follow a document through ingestion, hybrid search, reranking, and a streamed response with sources.

LangGraphHybrid retrieval7 stages

Read the walkthrough →

AutoHunt: from CV to reviewed application

Follow job matching, letter refinement, human approval, and application tracking through a stateful workflow.

LangGraphPlaywright10 stages

Read the walkthrough →

Decision Log

The constraints, choices, and tradeoffs behind the systems I build.

Why the architecture looks this way

  • DocsAI · Combine meaning with exact terminology
  • Vidly · Give analysis its own job lifecycle
  • myShell · Treat a pipeline as one foreground job

Explore 3 decisions →

Labs

Retrieval Inspector

Compare semantic search, term matching, hybrid fusion, and reranking against a sample document.

Shell Trace

Step through a pipeline and inspect its arguments, pipes, processes, and terminal ownership.

Contact

START A CONVERSATION

Have something in mind?

A project to build, a problem to solve, or an idea worth exploring. Send me a note.

Let’s make something useful.