Skip to content

README.md

Latest commit

 

History

History
100 lines (68 loc) · 1.96 KB

README.md

File metadata and controls

100 lines (68 loc) · 1.96 KB
Raw

trackr

🇭🇺 Hungarian version: README.hu.md
Simple CLI follow-up tracker (CRM-lite for job search and conversations).

Features

  • local SQLite storage
  • app data stored under %APPDATA%/trackr on Windows or ~/.trackr on Linux/macOS
  • YAML import/export
  • simple workflow states: created, waitme, waityou, finished
  • activity log and full history
  • optional description field on items
  • clipboard-driven workflow
  • automatic metadata extraction (email, phone, URLs, LinkedIn)
  • custom metadata support

Install

pipx install .

or

pip install -e .

Usage

trackr init

trackr add devops-role "DevOps Engineer Budapest" --desc "OpenShift role with recruiter contact"

trackr state devops-role waityou trackr note devops-role "CV sent" trackr set-review devops-role 2026-03-23

trackr list trackr review trackr activity trackr history devops-role

Apply multiple updates

trackr apply devops-role --state waityou --next-review 2026-03-25

trackr apply devops-role --note "Followed up via LinkedIn"

Clipboard workflow

trackr add-from-clipboard job-1

trackr add-from-clipboard job-1 --source linkedin

trackr note-from-clipboard job-1

trackr add-from-clipboard job-1 --meta company=EPAM --meta person=John

Metadata

When using clipboard input, trackr tries to extract:

  • email addresses
  • phone numbers
  • URLs
  • LinkedIn links

Example:

{ "email": "recruiter@example.com", "phone": "+36301234567", "linkedin": "https://linkedin.com/in/example", "source": "linkedin" }

YAML import format

items:

  • id: devops-role-FixY title: DevOps Engineer - Budapest description: | OpenShift-heavy role. Recruiter: fix Y state: waityou next_review: 2026-03-23 meta: recruiter: fix Y source: linkedin email: fixy@example.com

YAML export

trackr export-yaml backup.yaml

Extra

  • trackr history <item_id> shows full event history
  • trackr list --fields id,title,state shows compact output

License

MIT