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.2.tar.gz (101.6 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.2-py3-none-any.whl (120.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for jobtty-0.3.2.tar.gz
Algorithm Hash digest
SHA256 0ba7368353f2c2de3530a6d7ebad580dedb9a3c9a08fc64a25868d63dc359ed8
MD5 ef405ab03b2711f95f049230c7685db8
BLAKE2b-256 28bb40236c5d27483af17d8d704ab0f23f69d295db511eaf278736d78414356b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jobtty-0.3.2-py3-none-any.whl
  • Upload date:
  • Size: 120.7 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 88ea0b336dbce2b1da5bbee5eacf5942abcca62cb8e7628a64e541ab09b6d163
MD5 215c6bdd964711d72ddb8dcafbf9057b
BLAKE2b-256 a3fb3498beecdd8e3e951d2f25ca0f67e570bf2ffe9cbde2655a61b6422cd90b

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