repr-cli 0.1.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,263 @@
1
+ Metadata-Version: 2.4
2
+ Name: repr-cli
3
+ Version: 0.2.1
4
+ Summary: A beautiful, privacy-first CLI that analyzes your code repositories and generates a compelling developer profile
5
+ Author-email: Repr <hello@repr.dev>
6
+ License: MIT
7
+ Project-URL: Homepage, https://repr.dev
8
+ Project-URL: Documentation, https://repr.dev/docs
9
+ Project-URL: Repository, https://github.com/repr-app/cli
10
+ Keywords: cli,developer,profile,git,analysis,repr
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Operating System :: OS Independent
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Topic :: Software Development :: Version Control :: Git
21
+ Requires-Python: >=3.10
22
+ Description-Content-Type: text/markdown
23
+ License-File: LICENSE
24
+ Requires-Dist: typer>=0.9.0
25
+ Requires-Dist: rich>=13.0.0
26
+ Requires-Dist: gitpython>=3.1.0
27
+ Requires-Dist: pygments>=2.16.0
28
+ Requires-Dist: httpx>=0.25.0
29
+ Requires-Dist: openai>=1.0.0
30
+ Requires-Dist: keyring>=24.0.0
31
+ Provides-Extra: dev
32
+ Requires-Dist: pytest>=7.0.0; extra == "dev"
33
+ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
34
+ Requires-Dist: black>=23.0.0; extra == "dev"
35
+ Requires-Dist: ruff>=0.1.0; extra == "dev"
36
+ Dynamic: license-file
37
+
38
+ # Repr CLI
39
+
40
+ A local-first developer tool that turns your git commit history into professional narratives.
41
+
42
+ **Privacy Guarantee:** Zero data leaves your machine unless you explicitly publish. Your keys, your models, your data.
43
+
44
+ [![PyPI version](https://img.shields.io/pypi/v/repr-cli.svg)](https://pypi.org/project/repr-cli/)
45
+ [![Python versions](https://img.shields.io/pypi/pyversions/repr-cli.svg)](https://pypi.org/project/repr-cli/)
46
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
47
+ [![Build](https://github.com/repr-app/cli/actions/workflows/build-release.yml/badge.svg)](https://github.com/repr-app/cli/actions/workflows/build-release.yml)
48
+
49
+ ## Philosophy
50
+
51
+ Repr is built on three core principles:
52
+
53
+ 1. **Local-First:** Analysis happens on your machine. You own the output.
54
+ 2. **Bring Your Own Keys:** Use your own OpenAI API key or a local LLM (Ollama, etc.). We don't sit in the middle.
55
+ 3. **Opt-In Cloud:** Publishing to `repr.dev` is strictly optional. Use it for backup or sharing, or ignore it entirely.
56
+
57
+ ## Installation
58
+
59
+ ### macOS / Linux (Homebrew)
60
+ ```bash
61
+ brew tap repr-app/tap
62
+ brew install repr
63
+ ```
64
+
65
+ ### Direct Download
66
+ Download pre-built binaries for macOS, Linux, and Windows from the [latest release](https://github.com/repr-app/cli/releases/latest).
67
+
68
+ ### Python (pipx)
69
+ ```bash
70
+ pipx install repr-cli
71
+ ```
72
+
73
+ ## The Local Workflow
74
+
75
+ You can use Repr entirely offline or with your own API keys. No account required.
76
+
77
+ ### 1. Initialize
78
+ Scan for repositories and set up local config.
79
+
80
+ ```bash
81
+ repr init ~/code
82
+ ```
83
+
84
+ ### 2. Generate stories
85
+ Create stories from your commit history.
86
+
87
+ ```bash
88
+ # Using a local LLM (e.g., Ollama running Llama 3)
89
+ repr generate --local
90
+
91
+ # Or configure your own API key (BYOK)
92
+ repr llm add openai
93
+ repr generate
94
+
95
+ # Or use cloud (requires login)
96
+ repr login
97
+ repr generate --cloud
98
+ ```
99
+
100
+ This reads your git log, diffs, and file context to generate meaningful summaries of your work. All processing happens locally or directly against the API you specify.
101
+
102
+ ### 3. View your stories
103
+ Inspect the generated stories stored on your machine.
104
+
105
+ ```bash
106
+ repr stories
107
+ repr story view <id>
108
+ ```
109
+
110
+ Output is stored in `~/.repr/`, staying fully under your control.
111
+
112
+ ### 4. Track multiple repositories
113
+ Configure Repr to watch multiple projects.
114
+
115
+ ```bash
116
+ repr repos add ~/code/work-project
117
+ repr repos add ~/code/side-project
118
+ ```
119
+
120
+ ## Optional: Cloud & Publishing
121
+
122
+ If you want convenience without managing your own API keys, you can use Repr's backend. It processes your code with proprietary models but operates under a **zero data retention (ZDR) policy**—no logging, no storage beyond ephemeral processing.
123
+
124
+ Alternatively, use the cloud for backup and sharing: sync your locally generated stories or create a public profile (e.g., `repr.dev/yourname`).
125
+
126
+ **This is the only time data leaves your machine.**
127
+
128
+ ### 1. Authenticate
129
+ ```bash
130
+ repr login
131
+ ```
132
+
133
+ ### 2. Push stories
134
+ Publish your locally generated stories to your profile.
135
+
136
+ ```bash
137
+ repr push
138
+ ```
139
+
140
+ ### 3. Sync across devices
141
+ Keep your stories in sync.
142
+
143
+ ```bash
144
+ repr sync
145
+ ```
146
+
147
+ ### 4. Automate (Optional)
148
+ Install git hooks to automatically track new commits as you work.
149
+
150
+ ```bash
151
+ repr hooks install --all
152
+ ```
153
+
154
+ ## Configuration
155
+
156
+ Repr respects standard environment variables and local configuration.
157
+
158
+ **Config file:** `~/.repr/config.json`
159
+
160
+ ### Using Local LLMs (Ollama, LocalAI)
161
+ Point Repr to any OpenAI-compatible endpoint:
162
+
163
+ ```bash
164
+ repr llm configure
165
+ # Or manually:
166
+ repr config set llm.local_api_url http://localhost:11434/v1
167
+ repr config set llm.local_model llama3.2
168
+ ```
169
+
170
+ ### Bring Your Own Key (BYOK)
171
+ Configure your own API keys:
172
+
173
+ ```bash
174
+ repr llm add openai
175
+ repr llm add anthropic
176
+ repr llm use byok:openai
177
+ ```
178
+
179
+ ### Privacy Modes
180
+
181
+ | Mode | Command | Behavior |
182
+ |------|---------|----------|
183
+ | **Local LLM** | `repr generate --local` | Uses your local LLM endpoint (Ollama, etc.). Zero external network calls. |
184
+ | **BYOK** | `repr llm add <provider>` | Configure your own API keys (OpenAI, Anthropic, etc.). Direct connection, no middleman. |
185
+ | **Cloud** | `repr generate --cloud` | **(Requires Login)** Uses Repr's backend. Sends metadata + diffs. Zero data retention (ZDR) policy—no logging, ephemeral processing only. |
186
+ | **Offline** | Local operations only | Works without network. View stories, repos, export profiles. |
187
+
188
+ ## Command Reference
189
+
190
+ ### Getting Started
191
+ - `repr init [path]` - Initialize repr, scan for repositories
192
+ - `repr login` - Authenticate with repr.dev
193
+ - `repr whoami` - Show current user
194
+ - `repr logout` - Sign out
195
+ - `repr status` - Show overall status and health
196
+ - `repr mode` - Show current execution mode
197
+ - `repr doctor` - Run health checks and diagnostics
198
+
199
+ ### Generation & Analysis
200
+ - `repr generate [--local|--cloud]` - Generate stories from commits
201
+ - `--repo <path>` - Generate for specific repo
202
+ - `--commits <sha1,sha2>` - Generate from specific commits
203
+ - `--template <name>` - Use template (resume, changelog, narrative, interview)
204
+ - `--dry-run` - Preview what would be sent
205
+ - `repr week [--save]` - Show work from this week
206
+ - `repr since <date> [--save]` - Show work since a date
207
+ - `repr standup [--days N]` - Quick summary for standup
208
+
209
+ ### Stories
210
+ - `repr stories [--repo NAME] [--needs-review]` - List all stories
211
+ - `repr story <action> <id>` - Manage a story (view, edit, delete, hide, feature)
212
+ - `repr review` - Interactive review workflow
213
+ - `repr commits [--repo NAME] [--limit N]` - List recent commits
214
+
215
+ ### Cloud Operations
216
+ - `repr push [--story ID] [--all]` - Publish stories to repr.dev
217
+ - `repr sync` - Sync stories across devices
218
+ - `repr pull` - Pull remote stories to local
219
+
220
+ ### Repositories
221
+ - `repr repos [list|add|remove|pause|resume] [path]` - Manage tracked repos
222
+
223
+ ### Git Hooks
224
+ - `repr hooks install [--all|--repo PATH]` - Install post-commit hooks
225
+ - `repr hooks remove [--all|--repo PATH]` - Remove hooks
226
+ - `repr hooks status` - Show hook status
227
+
228
+ ### LLM Configuration
229
+ - `repr llm add <provider>` - Configure BYOK provider (openai, anthropic, groq, together)
230
+ - `repr llm remove <provider>` - Remove BYOK provider
231
+ - `repr llm use <mode>` - Set default mode (local, cloud, byok:<provider>)
232
+ - `repr llm configure` - Configure local LLM interactively
233
+ - `repr llm test` - Test LLM connection
234
+
235
+ ### Privacy
236
+ - `repr privacy explain` - Show privacy guarantees
237
+ - `repr privacy audit [--days N]` - Show what data was sent to cloud
238
+ - `repr privacy lock-local [--permanent]` - Disable cloud features
239
+ - `repr privacy unlock-local` - Re-enable cloud features
240
+
241
+ ### Configuration
242
+ - `repr config show [key]` - Display configuration
243
+ - `repr config set <key> <value>` - Set configuration value
244
+ - `repr config edit` - Open config in $EDITOR
245
+
246
+ ### Data Management
247
+ - `repr data` - Show local storage info
248
+ - `repr data backup [--output FILE]` - Backup all local data
249
+ - `repr data restore <file> [--merge]` - Restore from backup
250
+ - `repr data clear-cache` - Clear local cache
251
+
252
+ ### Profile
253
+ - `repr profile` - View profile
254
+ - `repr profile update [--preview]` - Generate/update profile from stories
255
+ - `repr profile set-bio <text>` - Set profile bio
256
+ - `repr profile set-location <text>` - Set location
257
+ - `repr profile set-available <bool>` - Set availability status
258
+ - `repr profile export [--format FORMAT]` - Export profile (md, json)
259
+ - `repr profile link` - Get shareable profile link
260
+
261
+ ## License
262
+
263
+ MIT License - see [LICENSE](LICENSE).
@@ -0,0 +1,23 @@
1
+ repr/__init__.py,sha256=5Lyw-m_Us0430M83D0ku-LzaZMoU9JnhjsmhPn09Z6U,269
2
+ repr/api.py,sha256=Rr6MEUkjf7LJ6TcxbdVstfpUM_mDpTKhllbFwy9jK2w,11893
3
+ repr/auth.py,sha256=-tqd2MMgFlowbhAqLHeSnVpDBkintkZ4kmPDZmczQFU,11682
4
+ repr/cli.py,sha256=67qBrsoV6VaBo7DcynJ8U9LGsYyPtIDGEQyCi4Etf7k,73990
5
+ repr/config.py,sha256=GZf5ucrBFIfOo9UtKE-DAZ9Ns1suAKG0jvUAY64oGIc,30601
6
+ repr/discovery.py,sha256=2RYmJleqV7TbxIMMYP2izkEBUeKH7U1F-U4KAUlUNww,14816
7
+ repr/doctor.py,sha256=6cI21xXIlTNRzHi2fRfHpm__erO8jBZc6vge8-29ip4,13404
8
+ repr/extractor.py,sha256=lGPN8gwTF_ZSezoQoPBMnf95nCJArGIteNiInfb39FM,10566
9
+ repr/hooks.py,sha256=DRpVXVv5Lesn9ARKHr-I91bUScab2It2TPjdwM38bT4,16864
10
+ repr/keychain.py,sha256=CpKU3tjFZVEPgiHiplSAtBQFDPA6qOSovv4IXXgJXbY,6957
11
+ repr/llm.py,sha256=gTYloz7ONTpFQm73YFIVGOrjsk0iyocMTM4YkF4s4xI,14598
12
+ repr/openai_analysis.py,sha256=-9POoLF6B15_oBKJw_CjKH2DuWEIgIlOmtyjS4Gjbck,25764
13
+ repr/privacy.py,sha256=HITso2pzwN8R0Izh3SjUsrzcpjVw5bJEhbippAGeMiY,9795
14
+ repr/storage.py,sha256=72nfFcR2Y98vpSjaO7zVHisq_Ln2UrHmGyDhEqEmDjU,14863
15
+ repr/templates.py,sha256=RQl7nUfy8IK6QFKzgpcebkBbQH0E_brbYh83pzym1TM,6530
16
+ repr/tools.py,sha256=QoGeti5Sye2wVuE-7UPxd_TDNXoen-xYfsFoT9rYRPs,20737
17
+ repr/ui.py,sha256=5jycUT-5Q0az4FFUzgarI8CfVAEEUPSEsT24Fad2kG8,3994
18
+ repr_cli-0.2.1.dist-info/licenses/LICENSE,sha256=tI16Ry3IQhjsde6weJ_in6czzWW2EF4Chz1uicyDLAA,1061
19
+ repr_cli-0.2.1.dist-info/METADATA,sha256=zUO3udSiT-IhCZAQ8Ms6ZSLSP2Bn3FCP0shJcGdbnqM,8824
20
+ repr_cli-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
21
+ repr_cli-0.2.1.dist-info/entry_points.txt,sha256=SJoKgNB-fRy6O2T_lztFr9T3ND_BQl0ijWxNW-J7dUU,38
22
+ repr_cli-0.2.1.dist-info/top_level.txt,sha256=LNgPqdJPQnlicRve7uzI4a6rEUdcxHrNkUq_2w7eeiA,5
23
+ repr_cli-0.2.1.dist-info/RECORD,,
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2024 ResumeFlow
3
+ Copyright (c) 2024 Repr
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal