Next-Generation Portable Terminal Simulator & Standalone USB Power Suite
Created by: Victor Kimutai
Live Demo: https://vectorshell.onrender.com/
VectorShell is an ultra-fast, modern web terminal interface and zero-dependency portable toolsuite designed for field operations, USB drives, and secure local automation. It combines a retro-inspired command-line workspace with dual-mode AI capabilities (live Gemini models + instant offline fallback) alongside cryptographically secure file encryption, SHA-256 wiping, duplicate detectors, and portable Python script generation.
- Modern retro terminal UI built with React, Vite, and Tailwind CSS.
- Clickable URL links for web addresses and external resources directly in output logs.
- Dual-mode AI assistant:
- Online Mode: Connected to Gemini API (
gemini-3.6-flash,gemini-3.1-flash-lite,gemini-flash-latest). - Offline Fallback: Instant local pattern matching and AI queries with zero external dependencies.
- Online Mode: Connected to Gemini API (
- Zero External Dependencies: Built using strictly Python standard library modules (
os,sys,shutil,subprocess,json,hashlib,secrets,math). - Downloadable directly from the terminal or main application UI with 1-click installer creation (
.batfor Windows and.shfor Linux/macOS). - Runs natively on Windows, macOS, and Linux without needing
pip install.
- File Encryption & Decryption: Multi-byte XOR cipher coupled with SHA-256 key derivation (
.agvfiles). - Cryptographic File Shredder: 3-pass overwrite mechanism (zeroes, 0xFF, and cryptographically secure random bytes) before deletion.
- Cryptographic Password Generator: Uses Python's
secretsmodule for high-entropy password generation. - Encrypted Vault Notes: Store confidential notes locally in
.usb_vault/notes.json.
- USB Partition & Disk Inspector: Real-time capacity auditing and breakdown.
- SHA-256 Duplicate File Finder: Detects identical files across directories by hash signatures.
- OS Temp File Cleaner: Scans and purges residual temporary operating system files.
- Automatic File Organizer: Sorts unsorted USB root files into
/Documents,/Media,/Code,/Archives, and/Executables.
| Command | Description | Example |
|---|---|---|
help |
Display interactive CLI cheatsheet and commands menu | help |
ask <query> |
Query the VectorShell AI Engine (online/offline) | ask how to encrypt a file |
encrypt <file> <passphrase> |
Encrypt a file using SHA-256 key derivation and multi-byte XOR | encrypt secrets.txt MyKey123 |
decrypt <file.agv> <passphrase> |
Decrypt a .agv encrypted vault file |
decrypt secrets.txt.agv MyKey123 |
shred <file> |
Securely wipe and obliterate a file with 3-pass overwrite | shred sensitive.pdf |
genpass [length] |
Generate a secure cryptographic password | genpass 24 |
disk |
Inspect USB storage partitions and space usage | disk |
clean |
Scan and remove OS temporary files | clean |
duplicates |
Scan for identical duplicate files by SHA-256 hash | duplicates |
organize |
Automatically categorize files into structured folders | organize |
sysinfo |
Run hardware diagnostics and operating system audit | sysinfo |
note add <title> <body> |
Save an encrypted note to the local vault | note add Pin 12345 |
note list |
Read saved notes from the local vault | note list |
setup |
Generate 1-click batch (.bat) and shell (.sh) launchers |
setup |
download |
Download the portable vectorshell.py script |
download |
cls / clear |
Clear the terminal screen buffer | clear |
- Push your repository to GitHub.
- Log into Render Dashboard.
- Click New + -> Blueprint.
- Connect your GitHub repository. Render will automatically detect
render.yaml. - Under Environment Variables, add your
GEMINI_API_KEY(optional, for live AI chat). - Click Apply.
- On Render Dashboard, click New + -> Web Service.
- Connect your GitHub repository containing VectorShell.
- Configure the following settings:
- Name:
vectorshell(or your preferred name) - Environment:
Node - Build Command:
npm install --include=dev && npm run build(ornpm install && npm run build) - Start Command:
npm run start
- Name:
- Under Environment Variables:
NODE_ENV:productionGEMINI_API_KEY: (Your Google Gemini API Key - optional for live AI chat)
- Click Create Web Service. Render will build and deploy VectorShell automatically!
VectorShell includes a GitHub Actions CI/CD workflow located at .github/workflows/ci-cd.yml.
- Continuous Integration (
lint-and-build):- Triggers automatically on every
pushorpull_requesttomain/masterbranches. - Installs Node v22 dependencies, runs TypeScript compilation checks (
npm run lint), and builds the production bundle (npm run build).
- Triggers automatically on every
- Continuous Deployment (
deploy):- Executes only after CI passes on the
mainormasterbranch. - Triggers automatic deployment to Render via Deploy Hook.
- Executes only after CI passes on the
- In your Render Dashboard, navigate to your VectorShell web service settings.
- Scroll to Deploy Hook and copy the Deploy Hook URL.
- In your GitHub repository, navigate to Settings -> Secrets and variables -> Actions.
- Create a new repository secret named
RENDER_DEPLOY_HOOK_URLand paste the URL. - Every time code is pushed and CI passes, GitHub Actions will trigger an instant deployment!
Created with care by Victor Kimutai.
To learn more about the author or explore other projects, visit:
https://victorkimutai.onrender.com
Distributed under the MIT License. Free for personal, commercial, and portable offline use.