DJINN DJINN

🖥️ TUI Features

Full-screen interactive terminal interfaces for monitoring, browsing, and testing.

📊 System Dashboard

A beautiful full-screen system monitor that displays real-time information about your system.

djinn dashboard

What It Shows

🔥 CPU

Per-core usage bars, total percentage, frequency

💾 Memory

RAM and Swap usage with visual bars

💿 Disks

Usage for each mounted partition

🌐 Network

Bytes sent/received, packet counts

⚡ Processes

Top 8 processes by CPU usage

Controls

  • Ctrl+C - Exit dashboard
  • Auto-refreshes every second

📁 File Explorer

Interactive terminal file manager for browsing and managing files.

djinn explore [path]

Commands

Command Description
ls List files in current directory
ls -a Show hidden files
cd <dir> Change directory
cd .. Go up one level
cd ~ Go to home directory
tree Show directory tree
mkdir <name> Create directory
rm <name> Remove file/directory
pwd Print working directory
q Quit explorer

Examples

$ djinn explore
$ djinn explore /var/log
$ djinn explore ~/projects

🗄️ Database Viewer

Browse and query databases directly in your terminal.

Supported Databases

  • SQLite (.db, .sqlite, .sqlite3)
  • PostgreSQL (requires psycopg2)
  • MySQL (requires mysql-connector-python)

Commands

Command Description
djinn db connect Find SQLite databases in current directory
djinn db connect file.db Connect to SQLite database
djinn db tables file.db List all tables with row counts
djinn db query file.db "SQL" Execute SQL query
djinn db info file.db Get database statistics

Examples

# Find databases
$ djinn db connect
Found Databases:
  • ./myapp.db
  • ./data/users.sqlite

# List tables
$ djinn db tables myapp.db
Tables:
  📋 users (1234 rows)
  📋 posts (5678 rows)
  📋 comments (9012 rows)

# Run query
$ djinn db query myapp.db "SELECT * FROM users LIMIT 5"
┌────┬──────────┬─────────────────┐
│ id │ name     │ email           │
├────┼──────────┼─────────────────┤
│ 1  │ John     │ john@example.com│
│ 2  │ Jane     │ jane@example.com│
└────┴──────────┴─────────────────┘

🌐 HTTP Client

Test APIs directly from your terminal with beautiful response rendering.

Methods

Command Description
djinn http get <url> GET request
djinn http post <url> -d 'json' POST request with JSON body
djinn http put <url> -d 'json' PUT request
djinn http delete <url> DELETE request

Options

  • -d, --data - JSON data for POST/PUT
  • -H, --header - Add header (key:value)

Examples

# Simple GET
$ djinn http get https://api.github.com/users/octocat

GET https://api.github.com/users/octocat
Status: 200 | Time: 234ms | Size: 1234 bytes
╭─ Response Body ─────────────────────────────────╮
│ {                                               │
│   "login": "octocat",                           │
│   "id": 583231,                                 │
│   "name": "The Octocat"                         │
│ }                                               │
╰─────────────────────────────────────────────────╯

# POST with JSON data
$ djinn http post https://api.example.com/users -d '{"name":"John","email":"john@example.com"}'

# With headers
$ djinn http get https://api.example.com -H "Authorization:Bearer token123"

📦 Universal Package Manager

One command for all package managers. Auto-detects project type.

Supported Package Managers

npm
yarn
pnpm
pip
poetry
cargo
go
gem
composer
apt
brew

Commands

Command Description
djinn pkg info Show detected package manager
djinn pkg install <pkg> Install package
djinn pkg install <pkg> -D Install as dev dependency
djinn pkg uninstall <pkg> Remove package
djinn pkg list List installed packages
djinn pkg update Update all packages
djinn pkg outdated Check for outdated packages

How It Works

DJINN detects your project type based on config files:

  • package.json → npm/yarn/pnpm
  • requirements.txt or pyproject.toml → pip/poetry
  • Cargo.toml → cargo
  • go.mod → go
  • Gemfile → gem
  • composer.json → composer

Examples

# In a Node.js project
$ djinn pkg install react
Using: npm
Installing react...
✅ Installed react

# In a Python project
$ djinn pkg install requests
Using: pip
Installing requests...
✅ Installed requests

# Force specific manager
$ djinn pkg install express --manager npm