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.0.tar.gz (94.2 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.0-py3-none-any.whl (107.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: jobtty-0.2.0.tar.gz
  • Upload date:
  • Size: 94.2 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.0.tar.gz
Algorithm Hash digest
SHA256 ad320cc4c5c647c8c1fe3dfba6e6c40403e25b5a0dc61e8302ad1e96ce874f92
MD5 afbb6529317d9605dd127845465c1146
BLAKE2b-256 462a382e801df2c9d48db294866d41bac6a2400182e6912dc00d99ee3d27ef66

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jobtty-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 107.1 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1a4abbefbbf3093dbde5d68e482548823d63a5059f430f86042c9b659b4cc701
MD5 fc34a6739bd374ea98c61ebbcf25bac2
BLAKE2b-256 5c79425394ffc0d6e179a5f91e8573ca05205e61810aa9679a64ff0a11865418

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