devdaily-ai 0.4.0 → 0.6.0

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "devdaily-ai",
3
- "version": "0.4.0",
3
+ "version": "0.6.0",
4
4
  "description": "Your AI memory for developer work - auto-generate PR descriptions, standup notes, and work summaries",
5
5
  "type": "module",
6
6
  "bin": {
@@ -24,13 +24,16 @@
24
24
  "keywords": [
25
25
  "cli",
26
26
  "git",
27
- "pr",
28
27
  "standup",
28
+ "pr",
29
+ "weekly-summary",
29
30
  "copilot",
30
31
  "ai",
31
- "developer-tools"
32
+ "developer-tools",
33
+ "productivity",
34
+ "devtools"
32
35
  ],
33
- "author": "",
36
+ "author": "Hem Pun <https://github.com/hempun10>",
34
37
  "license": "MIT",
35
38
  "repository": {
36
39
  "type": "git",
@@ -43,7 +46,9 @@
43
46
  "files": [
44
47
  "dist",
45
48
  "README.md",
46
- "LICENSE"
49
+ "LICENSE",
50
+ "CHANGELOG.md",
51
+ "CONTRIBUTING.md"
47
52
  ],
48
53
  "dependencies": {
49
54
  "boxen": "^8.0.1",
package/README.md.bak DELETED
@@ -1,595 +0,0 @@
1
- <div align="center">
2
-
3
- # DevDaily AI
4
-
5
- **Your AI-powered developer memory**
6
-
7
- Auto-generate standup notes, PR descriptions, and weekly summaries from your git history.
8
-
9
- [![NPM Version](https://img.shields.io/npm/v/devdaily-ai)](https://www.npmjs.com/package/devdaily-ai)
10
- [![Node Version](https://img.shields.io/node/v/devdaily-ai)](https://nodejs.org)
11
- [![License](https://img.shields.io/npm/l/devdaily-ai)](LICENSE)
12
- [![GitHub Stars](https://img.shields.io/github/stars/hempun10/devdaily)](https://github.com/hempun10/devdaily)
13
-
14
- [Installation](#installation) • [Quick Start](#quick-start) • [Commands](#commands) • [Examples](#examples) • [Contributing](docs/CONTRIBUTING.md)
15
-
16
- </div>
17
-
18
- ---
19
-
20
- ## Why DevDaily AI?
21
-
22
- As developers, we spend too much time on repetitive tasks:
23
-
24
- - ⏱️ Writing standup notes every morning
25
- - 📝 Crafting PR descriptions from scratch
26
- - 📊 Summarizing weekly accomplishments
27
- - 🔍 Remembering what we were working on last week
28
-
29
- **DevDaily AI solves this.** It analyzes your git history and uses GitHub Copilot CLI to generate professional summaries in seconds.
30
-
31
- ## Features
32
-
33
- | Feature | Description |
34
- | ---------------------------- | -------------------------------------------------------------------- |
35
- | **🚀 Standup Generator** | Generate daily standup notes from recent commits in 30 seconds |
36
- | **📄 Smart PR Descriptions** | Auto-generate PR titles and descriptions with commitlint integration |
37
- | **📅 Weekly Summaries** | Track your impact and accomplishments over time |
38
- | **�️ Interactive Dashboard** | Beautiful TUI with keyboard navigation and real-time stats |
39
- | **⚙️ Customizable Config** | Per-project and global configuration with themes |
40
- | **⌨️ Shell Integration** | `dd` alias, tab completions for bash/zsh/fish |
41
- | **🔄 Interactive Workflow** | Preview, edit, and create PRs with interactive menus |
42
- | **📋 Auto-Copy** | All outputs copied to clipboard automatically |
43
- | **🎨 Professional Output** | Clean terminal UI with ASCII art and beautiful formatting |
44
- | **🔧 Multi-Format** | Export to Markdown, Slack, JSON, or plain text |
45
-
46
- ## Installation
47
-
48
- **Prerequisites:**
49
-
50
- - Node.js >= 18.0.0
51
- - Git repository
52
- - GitHub CLI with Copilot extension
53
-
54
- ### Quick Install (Recommended)
55
-
56
- ```bash
57
- # Install DevDaily
58
- npm install -g devdaily-ai
59
-
60
- # Run doctor to check/fix prerequisites
61
- devdaily doctor --fix
62
-
63
- # Set up shell alias and completions
64
- devdaily init
65
- ```
66
-
67
- That's it! Now you can use `dd` as a shortcut anywhere.
68
-
69
- ### Manual Setup
70
-
71
- If you prefer to set up manually:
72
-
73
- #### 1. Install GitHub CLI (if not already installed)
74
-
75
- ```bash
76
- # macOS
77
- brew install gh
78
-
79
- # Windows
80
- winget install --id GitHub.cli
81
-
82
- # Linux
83
- sudo apt install gh # Debian/Ubuntu
84
- sudo dnf install gh # Fedora/RHEL
85
- ```
86
-
87
- Or visit [cli.github.com](https://cli.github.com) for other installation methods.
88
-
89
- #### 2. Install GitHub Copilot CLI Extension
90
-
91
- ```bash
92
- gh extension install github/gh-copilot
93
- gh auth login
94
- ```
95
-
96
- #### 3. Install DevDaily AI
97
-
98
- ```bash
99
- npm install -g devdaily-ai
100
- ```
101
-
102
- ### Verify Installation
103
-
104
- ```bash
105
- # Check everything is set up correctly
106
- devdaily doctor
107
-
108
- # Or manually check version
109
- devdaily --version
110
- devdaily --help
111
- ```
112
-
113
- ## Quick Start
114
-
115
- Navigate to any git repository and run:
116
-
117
- ```bash
118
- # First time setup (sets up 'dd' alias and shell completions)
119
- devdaily init
120
-
121
- # Generate standup notes
122
- devdaily standup # or: dd s
123
-
124
- # Generate PR description
125
- devdaily pr # or: dd p
126
-
127
- # Get weekly summary
128
- devdaily week # or: dd w
129
-
130
- # Open interactive dashboard
131
- devdaily dash # or: dd d
132
- ```
133
-
134
- All outputs are automatically copied to your clipboard! 📋
135
-
136
- ## Commands
137
-
138
- ### `devdaily standup`
139
-
140
- Generate daily standup notes from your recent commits.
141
-
142
- ```bash
143
- # Yesterday's work (default)
144
- devdaily standup
145
-
146
- # Last 3 days
147
- devdaily standup --days=3
148
-
149
- # Last week
150
- devdaily standup --days=7
151
-
152
- # Output in Slack format
153
- devdaily standup --format=slack
154
-
155
- # Plain text format
156
- devdaily standup --format=plain
157
-
158
- # Don't copy to clipboard
159
- devdaily standup --no-copy
160
- ```
161
-
162
- **Options:**
163
-
164
- - `--days, -d <number>` - Number of days to analyze (default: 1)
165
- - `--format, -f <format>` - Output format: markdown, slack, plain (default: markdown)
166
- - `--no-copy` - Don't copy to clipboard
167
-
168
- ### `devdaily pr`
169
-
170
- Generate comprehensive PR descriptions with smart title generation.
171
-
172
- ```bash
173
- # Generate PR description (interactive)
174
- devdaily pr
175
-
176
- # Create PR immediately
177
- devdaily pr --create
178
-
179
- # Create draft PR
180
- devdaily pr --draft
181
-
182
- # Compare to develop branch
183
- devdaily pr --base=develop
184
-
185
- # Don't copy to clipboard
186
- devdaily pr --no-copy
187
- ```
188
-
189
- **Options:**
190
-
191
- - `--base, -b <branch>` - Base branch to compare against (default: main)
192
- - `--create, -c` - Create PR on GitHub immediately
193
- - `--draft, -d` - Create PR as draft
194
- - `--no-copy` - Don't copy to clipboard
195
-
196
- **Interactive Menu:**
197
- When you run `devdaily pr` without flags, you get an interactive menu:
198
-
199
- - 👁️ Preview in terminal
200
- - 📋 Copy to clipboard
201
- - 🚀 Create PR on GitHub
202
- - 📝 Create draft PR
203
- - ❌ Cancel
204
-
205
- **Smart Features:**
206
-
207
- - Automatically generates PR title from conventional commits
208
- - Extracts issue numbers (e.g., "Closes #123")
209
- - Categorizes PR type (feature, bugfix, breaking change)
210
- - Parses commitlint messages for better titles
211
-
212
- ### `devdaily week`
213
-
214
- Generate weekly summary of your accomplishments.
215
-
216
- ```bash
217
- # Current week (default)
218
- devdaily week
219
-
220
- # Last week
221
- devdaily week --last
222
-
223
- # Custom start date
224
- devdaily week --start="2026-02-01"
225
-
226
- # Don't copy to clipboard
227
- devdaily week --no-copy
228
- ```
229
-
230
- **Options:**
231
-
232
- - `--last, -l` - Show last week instead of current week
233
- - `--start, -s <date>` - Custom start date (YYYY-MM-DD)
234
- - `--no-copy` - Don't copy to clipboard
235
-
236
- ### `devdaily context`
237
-
238
- Recover work context from past commits (coming soon).
239
-
240
- ```bash
241
- devdaily context --days=7
242
- ```
243
-
244
- ### `devdaily dash`
245
-
246
- Open the interactive dashboard with keyboard navigation.
247
-
248
- ```bash
249
- # Open dashboard
250
- devdaily dash
251
-
252
- # Short alias
253
- dd d
254
- ```
255
-
256
- **Keyboard Shortcuts:**
257
- - `s` - Generate standup
258
- - `p` - Generate PR description
259
- - `w` - Generate weekly summary
260
- - `c` - Open configuration
261
- - `r` - Refresh data
262
- - `q` - Quit
263
-
264
- ### `devdaily init`
265
-
266
- Set up DevDaily with shell aliases and completions.
267
-
268
- ```bash
269
- # Interactive setup
270
- devdaily init
271
-
272
- # Global setup (for all projects)
273
- devdaily init --global
274
-
275
- # Only set up alias
276
- devdaily init --alias
277
-
278
- # Only set up completions
279
- devdaily init --completions
280
- ```
281
-
282
- **Sets up:**
283
- - Shell alias: `dd` → `devdaily`
284
- - Tab completions for bash/zsh/fish
285
- - Configuration file
286
-
287
- ### `devdaily config`
288
-
289
- Manage DevDaily configuration.
290
-
291
- ```bash
292
- # Interactive config editor
293
- devdaily config
294
-
295
- # Open config in your editor
296
- devdaily config --edit
297
-
298
- # Show current config
299
- devdaily config --show
300
-
301
- # Show config file path
302
- devdaily config --path
303
-
304
- # Reset to defaults
305
- devdaily config --reset
306
- ```
307
-
308
- ### `devdaily doctor`
309
-
310
- Check system requirements and diagnose issues.
311
-
312
- ```bash
313
- # Check all prerequisites
314
- devdaily doctor
315
-
316
- # Attempt automatic fixes
317
- devdaily doctor --fix
318
-
319
- # Short alias
320
- devdaily check
321
- ```
322
-
323
- **Checks:**
324
- - ✅ Node.js version (>= 18)
325
- - ✅ Git installed
326
- - ✅ GitHub CLI installed
327
- - ✅ GitHub authentication
328
- - ✅ Copilot extension installed
329
-
330
- **Auto-fix capabilities:**
331
- - Interactive GitHub authentication
332
- - Copilot extension installation
333
-
334
- ## GitHub Issues Integration
335
-
336
- DevDaily automatically fetches GitHub issue context to provide **richer, more meaningful summaries**. When your commits reference issues (e.g., `fix #123`), DevDaily:
337
-
338
- 1. Fetches the issue title and description
339
- 2. Categorizes it (bug, feature, docs, etc.)
340
- 3. Includes the context in AI prompts for better summaries
341
-
342
- **Benefits:**
343
- - PR descriptions explain the *why* (business value), not just the *what*
344
- - Weekly summaries highlight impact by referencing completed issues
345
- - Standup notes include context about what you were working on
346
-
347
- **Usage:**
348
- ```bash
349
- # Normal usage (issues fetched automatically)
350
- devdaily standup
351
-
352
- # Skip issue fetching (faster, offline)
353
- devdaily standup --no-issues
354
- devdaily pr --no-issues
355
- devdaily week --no-issues
356
- ```
357
-
358
- ## Configuration
359
-
360
- DevDaily supports both global and per-project configuration.
361
-
362
- ### Config File Locations
363
-
364
- - **Global:** `~/.config/devdaily/config.json`
365
- - **Local:** `.devdailyrc` in your project root
366
-
367
- ### Example Configuration
368
-
369
- ```json
370
- {
371
- "version": 1,
372
- "theme": {
373
- "primary": "cyan",
374
- "accent": "magenta"
375
- },
376
- "ascii": true,
377
- "compactMode": false,
378
- "output": {
379
- "format": "markdown",
380
- "copyToClipboard": true,
381
- "showStats": true
382
- },
383
- "standup": {
384
- "defaultDays": 1
385
- },
386
- "pr": {
387
- "defaultBase": "main"
388
- },
389
- "week": {
390
- "startDay": "monday"
391
- }
392
- }
393
- ```
394
-
395
- ## Examples
396
-
397
- See the [`examples/`](examples/) directory for detailed output samples:
398
-
399
- - [Standup Output](examples/standup-output.md)
400
- - [PR Description Output](examples/pr-output.md)
401
- - [Weekly Summary Output](examples/week-output.md)
402
-
403
- ## How It Works
404
-
405
- 1. **Analyzes Git History** - Uses `simple-git` to parse commits, diffs, and file changes
406
- 2. **Extracts Context** - Parses conventional commits, issue numbers, and PR types
407
- 3. **AI Summarization** - Leverages GitHub Copilot CLI to generate human-readable summaries
408
- 4. **Professional Output** - Formats with clean terminal UI (chalk, boxen, ora)
409
- 5. **Auto-Copy** - Copies results to clipboard for immediate use
410
-
411
- ## Configuration
412
-
413
- DevDaily AI works out of the box with sensible defaults. No configuration file needed!
414
-
415
- All settings can be controlled via command-line flags.
416
-
417
- ## Development
418
-
419
- Want to contribute? See our [Contributing Guide](docs/CONTRIBUTING.md).
420
-
421
- ```bash
422
- # Clone the repository
423
- git clone https://github.com/hempun10/devdaily.git
424
- cd devdaily
425
-
426
- # Install dependencies
427
- npm install
428
-
429
- # Run in development mode
430
- npm run dev
431
-
432
- # Run tests
433
- npm test
434
-
435
- # Run tests in watch mode
436
- npm test -- --watch
437
-
438
- # Type checking
439
- npm run typecheck
440
-
441
- # Lint code
442
- npm run lint
443
- npm run lint:fix
444
-
445
- # Format code
446
- npm run format
447
-
448
- # Build for production
449
- npm run build
450
- ```
451
-
452
- ### Project Structure
453
-
454
- ```
455
- devdaily-ai/
456
- ├── src/
457
- │ ├── commands/ # CLI command implementations
458
- │ │ ├── standup.ts # Standup generator
459
- │ │ ├── pr.ts # PR description generator
460
- │ │ ├── week.ts # Weekly summary
461
- │ │ ├── dash.ts # Interactive dashboard
462
- │ │ ├── init.ts # Shell setup (aliases, completions)
463
- │ │ ├── config.ts # Configuration management
464
- │ │ └── context.ts # Context recovery (coming soon)
465
- │ ├── core/ # Core business logic
466
- │ │ ├── git-analyzer.ts # Git operations
467
- │ │ └── copilot.ts # Copilot CLI integration
468
- │ ├── ui/ # Terminal UI system
469
- │ │ ├── renderer.ts # Main UI rendering functions
470
- │ │ ├── colors.ts # Theme-aware color system
471
- │ │ ├── ascii.ts # ASCII art and symbols
472
- │ │ ├── help.ts # Beautiful help screens
473
- │ │ ├── dashboard.ts # Interactive TUI dashboard
474
- │ │ └── keyboard.ts # Keyboard input handling
475
- │ ├── config/ # Configuration system
476
- │ │ ├── schema.ts # Zod config schema
477
- │ │ └── index.ts # Config manager
478
- │ ├── utils/ # Utilities
479
- │ │ ├── helpers.ts # Date, clipboard utilities
480
- │ │ └── commitlint.ts # Commit parser
481
- │ ├── types/ # TypeScript type definitions
482
- │ └── index.ts # CLI entry point
483
- ├── tests/ # Test files
484
- ├── docs/ # Documentation
485
- ├── examples/ # Usage examples
486
- └── dist/ # Build output
487
- ```
488
-
489
- ## Tech Stack
490
-
491
- - **TypeScript** - Type-safe development
492
- - **Commander.js** - CLI framework
493
- - **simple-git** - Git operations
494
- - **execa** - Subprocess execution for Copilot CLI
495
- - **inquirer** - Interactive prompts
496
- - **chalk** - Terminal styling
497
- - **boxen** - Terminal boxes
498
- - **ora** - Loading spinners
499
- - **clipboardy** - Clipboard operations
500
-
501
- ## FAQ
502
-
503
- **Q: Does this work offline?**
504
- A: No, DevDaily AI requires GitHub Copilot CLI which needs an internet connection for AI summaries.
505
-
506
- **Q: What git hosting providers are supported?**
507
- A: DevDaily AI works with any git repository. GitHub CLI is only needed for creating PRs.
508
-
509
- **Q: Is my code sent to GitHub?**
510
- A: Only commit messages and diffs are sent to GitHub Copilot CLI for summarization. Full file contents are not shared.
511
-
512
- **Q: Can I customize the output format?**
513
- A: Yes! Use `--format` flag for standup command. PR and weekly commands support markdown by default.
514
-
515
- **Q: Does it work with monorepos?**
516
- A: Yes! DevDaily AI analyzes the entire git history of your current directory.
517
-
518
- **Q: What about conventional commits?**
519
- A: DevDaily AI parses conventional commits automatically and uses them for smart PR title generation.
520
-
521
- ## Troubleshooting
522
-
523
- ### Command not found: devdaily
524
-
525
- Make sure you installed globally:
526
-
527
- ```bash
528
- npm install -g devdaily-ai
529
- ```
530
-
531
- ### GitHub Copilot CLI not found
532
-
533
- Install the Copilot extension:
534
-
535
- ```bash
536
- gh extension install github/gh-copilot
537
- ```
538
-
539
- ### Not in a git repository
540
-
541
- DevDaily AI only works inside git repositories. Run:
542
-
543
- ```bash
544
- git init # Initialize a new repo
545
- # or
546
- cd /path/to/your/git/repo
547
- ```
548
-
549
- ### No commits found
550
-
551
- Make sure you have commits in your repository:
552
-
553
- ```bash
554
- git log # Check commit history
555
- ```
556
-
557
- For more help, see our [documentation](docs/) or [open an issue](https://github.com/hempun10/devdaily/issues).
558
-
559
- ## Roadmap
560
-
561
- - [ ] Support for Ollama (local AI models)
562
- - [ ] Analytics and tracking dashboard
563
- - [ ] Context recovery with AI-powered reminders
564
- - [ ] PR template detection and auto-fill
565
- - [ ] Integration with Jira/Linear/Asana
566
- - [ ] Team collaboration features
567
- - [ ] VS Code extension
568
-
569
- ## Contributing
570
-
571
- We welcome contributions! See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidelines.
572
-
573
- ## License
574
-
575
- MIT © [Hem Pun](https://github.com/hempun10)
576
-
577
- ## Acknowledgments
578
-
579
- Built for the [GitHub Copilot CLI Challenge](https://dev.to/devteam/join-the-github-copilot-cli-challenge-win-github-universe-tickets-copilot-pro-subscriptions-and-50af).
580
-
581
- Special thanks to:
582
-
583
- - GitHub Copilot CLI team
584
- - terminal.shop for UI inspiration
585
- - The awesome TypeScript community
586
-
587
- ---
588
-
589
- <div align="center">
590
-
591
- **[⬆ back to top](#devdaily-ai)**
592
-
593
- Made with ❤️ by developers, for developers
594
-
595
- </div>