Skip to main content

๐Ÿš€ Terminal Job Board - Find your next role from the command line

Project description

๐Ÿš€ Jobtty.io - Terminal Job Board

Find your next role from the command line! A beautiful, interactive terminal interface for job searching across multiple platforms.

     โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ•—
     โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ•šโ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ•šโ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ•šโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•”โ•
     โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•   โ–ˆโ–ˆโ•‘      โ–ˆโ–ˆโ•‘    โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ• 
โ–ˆโ–ˆ   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ•‘      โ–ˆโ–ˆโ•‘     โ•šโ–ˆโ–ˆโ•”โ•  
โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•   โ–ˆโ–ˆโ•‘      โ–ˆโ–ˆโ•‘      โ–ˆโ–ˆโ•‘   
 โ•šโ•โ•โ•โ•โ•  โ•šโ•โ•โ•โ•โ•โ• โ•šโ•โ•โ•โ•โ•โ•    โ•šโ•โ•      โ•šโ•โ•      โ•šโ•โ•   
                                                     
    ๐Ÿš€ Terminal Job Board โ€ข Find your next role

Features

  • ๐Ÿ” Multi-platform Search: Search jobs across ThamesAI.co.uk, Flutter.pl, and FlutterLondon.com
  • ๐Ÿ’ณ Premium Features: Stripe-powered premium job postings and featured listings
  • ๐ŸŽจ Beautiful Terminal UI: Rich colors, ASCII art, and interactive menus
  • ๐Ÿ” Secure Authentication: Keyring-based secure token storage
  • ๐Ÿ“Š Analytics: Track your applications and job posting performance
  • ๐Ÿ”– Bookmarking: Save jobs for later review
  • โš™๏ธ Configurable: Customize location, currency, and search preferences

Installation

pip install jobtty

Or install from source:

git clone https://github.com/croscomsoftware/jobtty.git
cd jobtty
pip install -e .

Quick Start

# Interactive mode
jobtty

# Search for jobs
jobtty search "python developer"
jobtty search "flutter" --remote --salary 80k

# Authentication
jobtty login
jobtty whoami

# Job posting
jobtty post --interactive

# Premium features
jobtty buy premium-listing --duration 30d

Commands

Authentication

jobtty login                    # Login to job board services
jobtty logout                   # Logout from all services
jobtty whoami                   # Show current user info

Job Search

jobtty search "query"           # Search all job boards
jobtty search --remote          # Remote jobs only
jobtty search --location "City" # Location filter
jobtty search --salary 80k      # Minimum salary filter
jobtty show 42                  # Show job details
jobtty save 42                  # Bookmark job
jobtty list --saved             # Show saved jobs

Job Posting

jobtty post                     # Interactive job posting
jobtty post --title "Developer" --company "TechCorp"
jobtty my-posts                 # Show your job postings

Premium Features

jobtty buy                      # Browse premium catalog
jobtty buy premium-listing      # Upgrade to premium
jobtty buy featured-post --job-id 123
jobtty billing --history       # Payment history

Configuration

jobtty config --location "Warsaw"
jobtty config --currency "EUR"
jobtty config --show           # Show all settings

API Integration

Jobtty integrates with:

  • Jobtty.io Production API: Main job board with 50+ companies (Meta, Google, Apple, Microsoft, Amazon, Spotify, etc.)
  • ThamesAI.co.uk: AI and technology jobs in London
  • Flutter.pl: Flutter and mobile development jobs in Poland
  • FlutterLondon.com: Flutter community jobs in London

Real-time Notifications

Get job alerts directly in your terminal while coding:

# Start the notification daemon
jobtty daemon start

# Continue coding... 
# ๐ŸŽฏ NEW JOB MATCH! (94% match)
# ๐Ÿข Google - Senior React Developer
# ๐Ÿ“ London ๐Ÿ  Remote | ๐Ÿ’ฐ ยฃ90K-120K
# ๐Ÿš€ jobtty apply ext_001

Premium Features

๐Ÿ’Ž Premium Listings (ยฃ29/month)

  • Featured placement in search results
  • 3x more visibility
  • Priority positioning
  • Advanced analytics

๐Ÿš€ Featured Posts (ยฃ49/month)

  • Top of search results
  • Highlighted appearance
  • Social media promotion
  • Extended duration (45 days)

๐Ÿ“Š Analytics Pro (ยฃ19/month)

  • Detailed application metrics
  • Candidate source tracking
  • Performance benchmarking
  • Export capabilities

๐ŸŽจ Company Branding (ยฃ99/month)

  • Custom brand colors
  • Company logo integration
  • Branded company page
  • Custom email templates

Configuration

Jobtty stores configuration in ~/.jobtty/:

  • config.json: User preferences and settings
  • user.json: Current user information
  • Secure tokens stored in system keyring

Default configuration:

{
  "location": "London, UK",
  "currency": "GBP", 
  "remote_only": false,
  "salary_min": 0,
  "preferred_sources": ["thamesai", "flutter_pl", "flutter_london"],
  "display_mode": "table",
  "auto_save_searches": true,
  "theme": "cyber"
}

Development

# Setup development environment
git clone https://github.com/croscomsoftware/jobtty.git
cd jobtty
pip install -e .
pip install -r requirements-dev.txt

# Run tests
pytest

# Run CLI in development
python -m jobtty.cli

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE file.

Support


Made with โค๏ธ by Croscom Software

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jobtty-0.3.4.tar.gz (107.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jobtty-0.3.4-py3-none-any.whl (120.8 kB view details)

Uploaded Python 3

File details

Details for the file jobtty-0.3.4.tar.gz.

File metadata

  • Download URL: jobtty-0.3.4.tar.gz
  • Upload date:
  • Size: 107.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for jobtty-0.3.4.tar.gz
Algorithm Hash digest
SHA256 13c1bebecebf9064142785c175c46d83522aeb81b7633020f671eacf5de70307
MD5 114aecf82f471a1d36a61cdd03f252ca
BLAKE2b-256 63795482aef4f0c396cb878d3735507c1fcd9b7f05ea7342a07b6aa94d33899c

See more details on using hashes here.

File details

Details for the file jobtty-0.3.4-py3-none-any.whl.

File metadata

  • Download URL: jobtty-0.3.4-py3-none-any.whl
  • Upload date:
  • Size: 120.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for jobtty-0.3.4-py3-none-any.whl
Algorithm Hash digest
SHA256 0c366680bb5abceceff963f47bd9dbfb41b93b5830d30559cf59a55c275f9d00
MD5 24110d48a459893a7c470efc1b9079ee
BLAKE2b-256 5cef9086775b8dadadda3843acdbadbc3b7e6f5a1159bab55d0386bd2cda9648

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page