satvik-pachipulusu/shellforgex

How satvik-pachipulusu/shellforgex works

ShellForge X is a C/POSIX interactive shell. Its main workflow reads commands in a REPL, records and dispatches them to built-ins or command, pipeline, and redirection execution. It also exposes job, memory, synchronization, dashboard, and AI features. The README describes telemetry and LLM integration as educational capabilities, with some still upcoming. The graph follows the visible shell dispatch; several implementation details and the Python helper’s wiring are not established by the excerpts.

Main entry points: shell.c Interactive REPL · main.c Program entry · pipeline.c Pipeline execution · ai.c AI assistance

Components 16

Shell interface

Program entry src/main.c
Interactive REPL src/shell.c
Signal setup src/signals.c
Command history src/history.c

Command execution

Built-in commands src/builtin.c
Command execution src/process.c
Pipeline execution src/pipeline.c
Command parser src/parser.c
I/O redirection src/redirection.c

Jobs and OS concepts

Job control src/jobs.c
Memory statistics src/memstat.c
Deadlock demo src/sync_demo.c

Educational features

OS dashboard src/dashboard.c
AI assistance src/ai.c
AI helper ai_helper.py

Other components

Shell user

Connections 16

Shell user → Program entry: starts shell README.md
Program entry → Signal setup: sets handlers src/main.c
Program entry → Interactive REPL: starts REPL src/main.c
Shell user → Interactive REPL: enters commands README.md
Interactive REPL → Command history: records commands src/shell.c
Interactive REPL → Built-in commands: dispatches built-ins src/shell.c
Interactive REPL → Command execution: dispatches commands src/shell.c
Interactive REPL → Pipeline execution: dispatches pipelines src/shell.c
Interactive REPL → I/O redirection: dispatches redirection src/shell.c
Pipeline execution → Command parser: parses commands src/pipeline.c
Interactive REPL → Job control: shows and reaps src/shell.c
Interactive REPL → Memory statistics: dispatches memstat src/shell.c
Interactive REPL → Deadlock demo: dispatches deadlock src/shell.c
Interactive REPL → OS dashboard: dispatches dashboard src/shell.c
Interactive REPL → AI assistance: dispatches AI requests src/shell.c
AI assistance → AI helper

Drawn by GitDiagram on November 15, 2026 from the repository's file tree, README and source files. Read as Markdown ·