CLI Tools
A look at the custom terminal-based utilities I use,
including Gemini CLI, to automate and enhance my creative process.
Custom terminal utilities for a frictionless creative pipeline.
Custom terminal utilities for a frictionless creative pipeline.
VOIDCOMMS
A lightweight, decentralised terminal-based Peer-to-Peer (P2P) messaging and file-sharing application designed for secure, offline-first communication. It combines a retro, responsive orange-themed Curses TUI wIth robust modern cryptography.
• End-to-End Encryption (E2EE): All messages and files are fully encrypted in transit using AES-128 in CBC mode signed with HMAC-SHA256 (derived via SHA-256 from a Pre-Shared Key).
• Acoustic Key Synchronsation: Allows two users sitting in the same room to pair securely without typing. The host plays the connection key as a near-ultrasonic, frequency-shift keying (FSK) audio sequence through the speakers, which the client records and decodes via microphone to automatically join the chat.
• Shared Folder Synchronizer: Watches a local directory
( ~/voidcomms_shared ) in the background. Dropping any file into this directory encrypts and broadcasts it, automatically syncing it to the corresponding shared folders of all connected peers in real-time.
• Multi-Peer Relaying: A host node can dynamically act as a relay server, bridging up to 10 clients simultaneously.
• Universal Plug & Play (UPnP): Automatically configures local router port-forwarding on startup to simplify peer connections over the internet, and cleans up the mappings cleanly upon exit
• Interactive Terminal Commands: Features terminal commands like /ping (latency check), /send (file transfer wizard), /acoustic (audio key broadcast), and /quit .
VORTEX
A highly sophisticated, SQLite-backed terminal "second brain" and AI personal vault tool. Built with Python (using typer , rich , and questionary ), it acts as an intelligent workspace that goes beyond basic note-taking by
leveraging local and cloud-based AI to analyse, query, and synthesise your thoughts.
* User must have pip install cryptography
POKEMENUBAR
I DO NOT OWN ANY RIGHTS TO THIS PROJECT
THEREFORE THIS IS NOT AN APPLICATION FOR SALE
THIS IS TO DEMONSTRATE MY SKILLS
A highly polished MacOS companion application built natively in Swift using SwiftUI and AppKit. It blends nostalgic pixel-art animations with modern desktop automation, system monitoring, and logic to create a delightful, context-aware digital pet experience
• Menu Bar Companions:
Spawns animated pixel-art Pokémon statusitems in the MacOS Menu Bar. Clicking them opens a popover containing level progress, inventory management, and a chat window.
• Dock Walkers:
Transparent overlay windows NSPanel that let Pokémon walk, run, jump, and lounge directly on top of or near the MacOS Dock.
• Neural Core (Gemini AI): Connects to the Gemini API ( gemini-1.5-flash ) for unscripted conversations, specifically
prompted to output British English spellings (colour, standardised, etc.).
• Active System Monitoring:
A background system watcher tracks your active frontmost application (e.g., Blender, Photoshop, Resolve, VS Code) so Pokémon can chime in with context-aware thoughts.
• File Scavenging & Watching:
Uses Apple's Spotlight metadata queries to find creative assets and folder watchers to alert you when new files are saved.
• Dynamic Battle System: Automatically triggers a turn-based battle when two Dock Walkers walk past each other. Damage calculations are determined by type matchups (Fire, Water, Grass, etc.).
• Safari Zone & Catching:
Randomly spawns wild Pokémon on your Dock (with a 1% shiny rate) which can be captured using custom PokéBalls.
• Progression & Inventory:
Provides items like Rare Candy (increases XP/Level) and Potions (heals HP) to level up your companions and track them in a 151 PokéDex.
• Autonomous Vault Agent: A goal-oriented AI agent that observes your vault context and autonomously performs actions (like searching, creating, and cleaning up notes) to achieve complex user-defined objectives.
• Live AI Chat Mode: A chat interface where your conversation with the AI is saved dynamically as tagged notes, allowing the assistant to refer back to prior conversation threads.
• AI Insight & Synthesis: An AI engine (configured to use Google Gemini or local Ollama models) analyses your note database, identifies hidden connections between similar notes, and synthesises them into new ideas, project drafts, or insights.
• Fuzzy & Semantic Search: Fuzzy keyword matching, Vortex generates vectors for your notes using Ollama enabling semantic search queries based on the meaning of your ideas rather than just keywords.
• Local SQLite Notes Vault: A clean note-taking system featuring tag categorisation and standard external text editor integration (e.g., launching nano for writing/capture).
• Sleek TUI / Dashboard: An interactive terminal dashboard with animated CLI menus, Rich tables/panels, custom tag colors, and clean text layouts.