Skip to content

Commit b20a847

Browse files
csibepapacsibepapa
committed
add new meta extraction and clipbord feature
1 parent 60efb02 commit b20a847

5 files changed

Lines changed: 387 additions & 25 deletions

File tree

‎README.hu.md‎

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
# trackr
2+
3+
Egyszerű CLI alapú follow-up tracker (mini CRM álláskereséshez és kommunikáció követéshez).
4+
5+
## Funkciók
6+
7+
- helyi SQLite adatbázis
8+
- adat tárolása Windows alatt %APPDATA%/trackr, Linux/macOS alatt ~/.trackr
9+
- YAML import/export
10+
- egyszerű workflow státuszok: created, waitme, waityou, finished
11+
- aktivitás napló és teljes eseménytörténet
12+
- opcionális description mező
13+
- clipboard alapú használat
14+
- automatikus metaadat felismerés (email, telefonszám, URL-ek, LinkedIn)
15+
- egyedi metaadatok támogatása
16+
17+
## Telepítés
18+
19+
pipx install .
20+
21+
vagy
22+
23+
pip install -e .
24+
25+
## Használat
26+
27+
trackr init
28+
29+
trackr add devops-role "DevOps Engineer Budapest" --desc "OpenShift pozíció recruiter kapcsolattal"
30+
31+
trackr state devops-role waityou
32+
trackr note devops-role "CV elküldve"
33+
trackr set-review devops-role 2026-03-23
34+
35+
trackr list
36+
trackr review
37+
trackr activity
38+
trackr history devops-role
39+
40+
## Több módosítás egyszerre
41+
42+
trackr apply devops-role --state waityou --next-review 2026-03-25
43+
44+
trackr apply devops-role --note "LinkedIn follow-up elküldve"
45+
46+
## Clipboard workflow
47+
48+
trackr add-from-clipboard job-1
49+
50+
trackr add-from-clipboard job-1 --source linkedin
51+
52+
trackr note-from-clipboard job-1
53+
54+
trackr add-from-clipboard job-1 --meta company=EPAM --meta person=John
55+
56+
## Metaadatok
57+
58+
A clipboard tartalomból automatikusan felismeri:
59+
60+
- email címek
61+
- telefonszámok
62+
- URL-ek
63+
- LinkedIn linkek
64+
65+
Példa:
66+
67+
{
68+
"email": "recruiter@example.com",
69+
"phone": "+36301234567",
70+
"linkedin": "https://linkedin.com/in/example",
71+
"source": "linkedin"
72+
}
73+
74+
## YAML import formátum
75+
76+
items:
77+
- id: devops-role-FixY
78+
title: DevOps Engineer - Budapest
79+
description: |
80+
OpenShift fókuszú szerep.
81+
Recruiter: fix Y
82+
state: waityou
83+
next_review: 2026-03-23
84+
meta:
85+
recruiter: fix Y
86+
source: linkedin
87+
email: fixy@example.com
88+
89+
## YAML export
90+
91+
trackr export-yaml backup.yaml
92+
93+
## Extra
94+
95+
- trackr history <item_id> teljes eseménytörténetet mutat
96+
- trackr list --fields id,title,state tömör listát ad
97+
98+
## Licenc
99+
100+
MIT

‎README.md‎

Lines changed: 57 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,78 @@
11
# trackr
2-
3-
Simple CLI follow-up tracker.
2+
🇭🇺 Hungarian version: [README.hu.md](README.hu.md)
3+
Simple CLI follow-up tracker (CRM-lite for job search and conversations).
44

55
## Features
66

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

1417
## Install
1518

16-
```bash
1719
pipx install .
18-
```
1920

2021
or
2122

22-
```bash
2323
pip install -e .
24-
```
2524

2625
## Usage
2726

28-
```bash
2927
trackr init
28+
3029
trackr add devops-role "DevOps Engineer Budapest" --desc "OpenShift role with recruiter contact"
30+
3131
trackr state devops-role waityou
3232
trackr note devops-role "CV sent"
3333
trackr set-review devops-role 2026-03-23
34+
3435
trackr list
3536
trackr review
3637
trackr activity
3738
trackr history devops-role
38-
```
39+
40+
## Apply multiple updates
41+
42+
trackr apply devops-role --state waityou --next-review 2026-03-25
43+
44+
trackr apply devops-role --note "Followed up via LinkedIn"
45+
46+
## Clipboard workflow
47+
48+
trackr add-from-clipboard job-1
49+
50+
trackr add-from-clipboard job-1 --source linkedin
51+
52+
trackr note-from-clipboard job-1
53+
54+
trackr add-from-clipboard job-1 --meta company=EPAM --meta person=John
55+
56+
## Metadata
57+
58+
When using clipboard input, trackr tries to extract:
59+
60+
- email addresses
61+
- phone numbers
62+
- URLs
63+
- LinkedIn links
64+
65+
Example:
66+
67+
{
68+
"email": "recruiter@example.com",
69+
"phone": "+36301234567",
70+
"linkedin": "https://linkedin.com/in/example",
71+
"source": "linkedin"
72+
}
3973

4074
## YAML import format
4175

42-
```yaml
4376
items:
4477
- id: devops-role-FixY
4578
title: DevOps Engineer - Budapest
@@ -51,8 +84,17 @@ items:
5184
meta:
5285
recruiter: fix Y
5386
source: linkedin
54-
```
87+
email: fixy@example.com
88+
89+
## YAML export
90+
91+
trackr export-yaml backup.yaml
5592

5693
## Extra
5794

58-
- `trackr history <item_id>` shows the event history for a single item.
95+
- trackr history <item_id> shows full event history
96+
- trackr list --fields id,title,state shows compact output
97+
98+
## License
99+
100+
MIT

‎pyproject.toml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@ description = "CLI follow-up tracker (jobs, tasks, pipelines)"
55
authors = [{name = "Gabor"}]
66
dependencies = [
77
"typer[all]",
8-
"pyyaml"
8+
"pyyaml",
9+
"pyperclip"
910
]
1011
requires-python = ">=3.10"
1112

0 commit comments

Comments
 (0)