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.2.1.tar.gz (94.4 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.2.1-py3-none-any.whl (107.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for jobtty-0.2.1.tar.gz
Algorithm Hash digest
SHA256 37143f0a521e80ea721398a9cfb709cb3c5dfd4b43656caf77638d7f77477ad8
MD5 c3ccecbea3239371b6e39149bbbd5732
BLAKE2b-256 4b0f725a75c56ad5573e9a91a770f416f633cae1a635a30d7baf344896194d6a

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for jobtty-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 48a7b821b32539e5e7a7af5cea571ebd3ff5da93f042b036003180829a6e2bd5
MD5 efee4634cf583267f563f56fadeaaf24
BLAKE2b-256 252fb2cc52820ead2694aa5a81c9d745a7d9371b2afffa2f017026eb46c9aa75

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