amancli 🚀

Interactive Terminal Portfolio & CLI Resume
A fast, elegant, and interactive terminal-based developer portfolio for Aman Prajapati built with Node.js, TypeScript, and modern CLI tools.

📖 Table of Contents

• Overview
• Quick Start
• Key Features
• Installation Guide
  • npm Global Install
  • Run with npx
  • Install from Source (Local Link)
• Usage Guide
  • Interactive Shell Mode
  • Direct Command Mode (One-Shot)
• Command Reference
• AI Chatbot (amancli chat)
• Color Themes
• Project Architecture
• Customization Guide
• Development & Scripts
• Connect & Author

🌟 Overview

amancli transforms a developer resume and project showcase into an interactive command-line experience. Instead of scrolling through a traditional static web portfolio or PDF, recruiters, engineers, and visitors can browse projects, check skills, read experience highlights, switch themes, or launch live demos directly from their terminal.

It can be used in two ways:

1. Interactive Shell: A full terminal environment complete with ASCII banner, autocomplete, command history, and a responsive prompt.
2. Direct CLI Utility: One-shot execution of subcommands directly from Bash, Zsh, PowerShell, or Windows Command Prompt.

✨ Key Features

• ⚡ Interactive Terminal Environment: Simulated shell session featuring an animated boot loader, custom prompt (➜), and clean output formatting.
• ⇥ Tab Autocompletion: Autocompletion for commands, project slugs/IDs, and available theme names.
• 📜 Command History: Navigate previous commands seamlessly using the ↑ and ↓ arrow keys.
• 🎨 Multi-Theme Engine: 5 built-in color schemes (orange, green, blue, purple, monochrome) saved persistently to ~/.mycli_theme.
• 📁 Detailed Project Browser: Inspect project overviews, tech stacks, GitHub links, and live web deployments by project ID or name.
• 🌐 Web & System Integration: Automatically opens live projects, GitHub profiles, LinkedIn profiles, or local resume.pdf in the default browser/system viewer.
• 🤖 AI Chatbot Integration: Ask questions about Aman, his projects, skills, and experience powered by an Activepieces automation webhook.
• ⚡ Zero Hassle: Built with TypeScript ES Modules, compiled cleanly with tsc, and runnable with tsx during development.

⚡ Quick Start

Get up and running in seconds:

# 1. Install globally from npm
npm install -g amandotcli

# 2. Launch the interactive portfolio
amancli

Or run directly without installing:

npx amandotcli

🚀 Installation Guide

npm Global Install (Recommended)

Install the CLI globally on your system:

npm install -g amandotcli

Once installed, run:

amancli

Check the installed version:

amancli --version

Run with npx (No Install Required)

You can launch the CLI directly in any terminal without installing globally:

npx amandotcli

Install from Source (Local Link)

If you want to contribute, tweak colors, or build locally:

# 1. Clone the repository
git clone https://github.com/Amandot/my-cli.git
cd my-cli

# 2. Install dependencies
npm install

# 3. Build TypeScript source
npm run build

# 4. Link globally
npm link

Now you can invoke amancli anywhere in your terminal:

amancli

Running Without Installation

You can also run directly from the repository without global linking:

# Development mode (runs tsx directly)
npm run dev

# Or run the compiled build
npm run build
node dist/index.js

🖥️ Usage Guide

1. Interactive Shell Mode

Running amancli with no arguments launches the interactive terminal resume:

amancli

You will see the welcome banner and prompt:

┌──────────────────────────────────────────────────┐
│ aman@prajapati: ~/resume                         │
│                                                  │
│   █████╗ ██████╗                                 │
│  ██╔══██╗██╔══██╗                                │
│  ███████║██████╔╝                                │
│  ██╔══██║██╔═══╝                                 │
│  ██║  ██║██║                                     │
│  ╚═╝  ╚═╝╚═╝                                     │
│                                                  │
│  Interactive Terminal Resume                     │
│  Full Stack Developer • AI Enthusiast • Student  │
│                                                  │
│  Type 'help' to see available commands           │
│  Press 'tab' to auto-complete commands           │
└──────────────────────────────────────────────────┘

➜ 

Interactive Tips:

• Press Tab at any time to autocomplete commands (e.g. th<Tab> -> theme).
• Use ↑ / ↓ arrow keys to cycle through previously executed commands.
• Quick single-letter aliases exist for primary commands (e.g. p for projects, s for skills).
• Type exit or q to quit the session.

2. Direct Command Mode (One-Shot)

You can run commands directly without entering the interactive shell:

# View summary about Aman
amancli about

# List technical skills
amancli skills

# View all projects
amancli projects

# View details of a specific project (by ID or name)
amancli project 1
amancli project questai

# Open resume PDF in default viewer
amancli resume

# Change color theme
amancli theme blue

📋 Command Reference

| Command | Shorthand | Description | Example | | :--- | :---: | :--- | :--- | | about | a | Display bio, education overview, and summary | amancli about | | skills | s | Display categorized technical skills | amancli skills | | projects [id/name] | p | List all projects or inspect a specific project | amancli projects | | project <id/name> | - | View in-depth details of a specific project | amancli project 2 | | experience | e | Display work experience and fellowships | amancli experience | | education | - | Display academic timeline, degree, and CGPA | amancli education | | achievements | - | List awards, ideathon wins, and certifications | amancli achievements | | contact | c | Display contact methods (email, phone, socials) | amancli contact | | chat | - | Interactive AI chatbot asking questions about Aman | amancli chat | | github | - | Open Aman's GitHub profile in the default browser | amancli github | | linkedin | - | Open Aman's LinkedIn profile in the default browser | amancli linkedin | | resume | - | Open the resume.pdf document locally | amancli resume | | theme [name] | - | View or change color theme (orange, green, blue, purple, mono) | theme green | | whoami | - | Display identity and primary roles | whoami | | pwd | - | Print current simulated location (~/resume) | pwd | | date | - | Display current date, time, and timezone | date | | clear | - | Clear the terminal screen | clear | | help | h | Display available commands and tips | help | | exit | q | Exit the interactive session | exit |

🤖 AI Chatbot (amancli chat)

amancli includes an interactive AI assistant connected to an Activepieces automation webhook. Visitors and recruiters can ask natural language questions about Aman's background, projects, skills, education, and experience.

Usage

Run directly from terminal:

amancli chat

Or enter from inside the interactive shell:

➜ chat

Inside chat mode:

╭───────────────────╮
│ Ask me about Aman │
╰───────────────────╯
Ask me about Aman, his projects, skills, education, achievements, or experience.
Type `exit` to leave.

You: What projects has Aman built?
🤖 Aman has worked on several projects including GiveBack, QuestAI, Climate Action Engine, and FitChain...

Custom Webhook Configuration

By default, amancli connects seamlessly out-of-the-box. To route questions to your own custom Activepieces automation flow or private endpoint, set the AMANCLI_CHAT_WEBHOOK environment variable:

Windows PowerShell:

$env:AMANCLI_CHAT_WEBHOOK="YOUR_WEBHOOK_URL"
amancli chat

Linux / macOS / Termux:

export AMANCLI_CHAT_WEBHOOK="YOUR_WEBHOOK_URL"
amancli chat

Activepieces Automation Flow

The automation flow follows this pipeline:

Catch Webhook (POST)
       ↓
 AI Agent / AI Step
       ↓
  Return Response
       ↓
    amancli

Request Payload:

{
  "question": "What projects has Aman built?"
}

Expected Response Payload:

{
  "response": "Aman has built GiveBack, QuestAI, FitChain, and Climate Action Engine."
}

Note: The CLI also automatically supports alternative keys such as message, answer, data.response, or plain text responses.

🎨 Color Themes

amancli includes 5 custom-designed color schemes. Your preference is automatically saved to ~/.mycli_theme and persists across sessions:

| Theme Name | Alias / Number | Aesthetic | | :--- | :---: | :--- | | Amber Orange (Default) | orange / 1 | High-energy warm amber and slate accents | | Matrix Green | green / 2 | Hacker terminal green | | Cyber Blue | blue / 3 | Futuristic cyan and sky blue | | Neon Purple | purple / 4 | Modern electric purple & violet | | Clean Monochrome | monochrome / mono / 5 | Minimalist grayscale and clean white |

To switch themes inside the interactive prompt:

➜ theme green

Or directly from the terminal:

amancli theme purple

📁 Project Architecture

my-cli/
├── dist/                  # Compiled JavaScript output (ES Modules)
├── src/                   # TypeScript source code
│   ├── commands/          # Command handler implementations
│   │   ├── about.ts       # 'about' command (bio & profile overview)
│   │   ├── achievements.ts# 'achievements' command (awards & certs)
│   │   ├── contact.ts     # 'contact' command (email, socials, phone)
│   │   ├── education.ts   # 'education' command (degrees & college)
│   │   ├── experience.ts  # 'experience' command (internships & fellowships)
│   │   ├── help.ts        # 'help' command (command list & tips)
│   │   ├── projects.ts    # 'projects' and 'project <query>' handlers
│   │   ├── skills.ts      # 'skills' command (categorized tech stack)
│   │   ├── system.ts      # 'whoami', 'pwd', 'date', 'resume' handlers
│   │   └── theme.ts       # 'theme' switcher logic
│   ├── data/
│   │   └── resume.ts      # Central resume data source & TypeScript interfaces
│   ├── ui/
│   │   ├── banner.ts      # Startup animation and ASCII header box
│   │   ├── colors.ts      # Theme definitions, chalk instances & persistence
│   │   └── formatting.ts  # Boxen, text wrapping & header utilities
│   ├── utils/
│   │   ├── browser.ts     # Safe URL opening in system browser
│   │   └── terminal.ts    # Terminal clearing & sleep helpers
│   ├── index.ts           # CLI entry point (Commander CLI configuration)
│   └── interactive.ts     # Readline interactive REPL session & autocompleter
├── package.json           # Project manifest, dependencies, and bin entry
├── resume.pdf             # Bundled resume document
├── tsconfig.json          # TypeScript compiler configuration
└── README.md              # Project documentation

🛠️ Customization Guide

Want to fork this repo and turn it into your own CLI resume? It's straightforward:

1. Update Personal Data: Open src/data/resume.ts and modify:

   • profile: Your name, role, bio, and educational institution.
   • skills: Your programming languages, frameworks, databases, and tools.
   • projects: Your project names, descriptions, tech stacks, and repo URLs.
   • experience: Your internships, fellowships, or employment records.
   • education & achievements: Degrees, timeline, and certifications.
   • contact: Your email, social links, and handles.

2. Update External Links & CLI Name:

   • In src/index.ts, update the program name, description, and social shortcuts (github, linkedin).
   • In package.json, update name, bin command name, and description.

3. Replace Resume File:

   • Drop your updated resume.pdf into the root directory.

4. Rebuild:

   npm run build

💻 Development & Scripts

| Script | Command | Purpose | | :--- | :--- | :--- | | Run Dev | npm run dev | Runs TypeScript source code directly with tsx without precompiling | | Build | npm run build | Compiles TypeScript files in src/ to JavaScript in dist/ |

📬 Connect & Author

Aman Prajapati
Full Stack Developer • AI Enthusiast • Computer Engineering Student
📍 Mumbai, Maharashtra, India

• GitHub: @Amandot
• LinkedIn: Aman Prajapati
• Email: [email protected]

📄 License

This project is licensed under the MIT License. Feel free to use it as inspiration for your own terminal portfolio!