💻 CLI Documentation

Complete guide to using JobTTY from your terminal. Find, apply, and manage jobs without leaving your code editor.

🚀 Quick Start

Installation

# Install via pip

pip install jobtty

# Or install globally

pip3 install -g jobtty

First Steps

# Check installation

jobtty --version

# Create account or login

jobtty login

# Start searching for jobs

jobtty search "python developer"

⚡ Core Commands

jobtty search "ruby developer"

CMD1

Search for Ruby developer jobs

EXAMPLE:

jobtty search "ruby developer" --location London --remote

jobtty show <job_id>

CMD2

View detailed job information

EXAMPLE:

jobtty show 123

jobtty apply <job_id>

CMD3

Apply to a job with your CV

EXAMPLE:

jobtty apply 123 --cover-letter "I am interested..."

jobtty login

CMD4

EXAMPLE:

jobtty login

jobtty profile

CMD5

View and edit your profile

EXAMPLE:

jobtty profile show

jobtty daemon start

CMD6

Start background job notifications

EXAMPLE:

jobtty daemon start

🔧 Advanced Usage

🔍 Search Filters

# Location-based search

jobtty search "react" --location "London"

# Remote jobs only

jobtty search "fullstack" --remote

# Save search for notifications

jobtty search "senior python" --save

# Combined filters

jobtty search "ruby developer" --location "Berlin" --remote --save

👤 Profile Management

# View your profile

jobtty profile show

# Upload your CV

jobtty profile upload-cv ~/resume.pdf

# Update profile info

jobtty profile update --name "John Doe" --location "London"

🔔 Background Notifications

# Start background daemon

jobtty daemon start

# Check daemon status

jobtty daemon status

# Stop notifications

jobtty daemon stop

💡 The daemon monitors your saved searches and sends notifications when new matching jobs are posted.

📝 Application Workflow

Complete Application Process

Search for Jobs

Use filters to find relevant positions

jobtty search "senior developer" --location "Remote"

Review Job Details

Get full information about the role

jobtty show 123

Apply with CV

Submit application with cover letter

jobtty apply 123 --cover-letter "I'm excited about this role..."

Track Applications

Monitor application status

jobtty applications list

🛠️ Troubleshooting

Common Issues

❌ "Command not found: jobtty"

Solution: Ensure pip installation path is in your PATH

export PATH=$PATH:~/.local/bin

❌ "Authentication failed"

Solution: Re-login to refresh your session

jobtty logout && jobtty login

❌ "No jobs found"

Solution: Try broader search terms or remove location filters

jobtty search "developer" --remote

Get Help

📧 Email: hello@jobtty.io

💬 Live Chat: Available on jobtty.io

🐛 Bug Reports: GitHub Issues

📋 Quick Reference

Version: 1.1.4

Python: 3.7+

License: MIT

Platform: Cross-platform

📦 View on PyPI

🎬 Video Tutorial

▶️

5-minute CLI walkthrough

💻 Try It Live

Test CLI commands directly in your browser using our interactive terminal.

🚀 Launch Terminal

📱 Latest Updates

v1.1.4 - Current

• Improved search filters

• Better error handling

• Performance optimizations

v1.1.3

• Background notifications

• Profile management