deploylog 0.2.0 → 0.2.1
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/README.md +138 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/Idzuo32/deploylog-cli/main/.github/assets/logo.png" width="120" alt="DeployLog" />
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<h1 align="center">deploylog</h1>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
Push changelog entries from the terminal. Generate release notes from git with one flag. Rewrite them with Claude Haiku with another.
|
|
9
|
+
</p>
|
|
10
|
+
|
|
11
|
+
<p align="center">
|
|
12
|
+
<a href="https://www.npmjs.com/package/deploylog"><img src="https://img.shields.io/npm/v/deploylog.svg" alt="npm"></a>
|
|
13
|
+
<a href="https://www.npmjs.com/package/deploylog"><img src="https://img.shields.io/npm/dm/deploylog.svg" alt="downloads"></a>
|
|
14
|
+
<img src="https://img.shields.io/node/v/deploylog.svg" alt="node">
|
|
15
|
+
<img src="https://img.shields.io/npm/l/deploylog.svg" alt="license">
|
|
16
|
+
</p>
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Install
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
npm i -g deploylog
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Node 18+ required.
|
|
27
|
+
|
|
28
|
+
## Authenticate
|
|
29
|
+
|
|
30
|
+
Create an API key in your dashboard at [deploylog.dev/dashboard/api-keys](https://deploylog.dev/dashboard/api-keys), then:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
deploylog login --key dk_xxx
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Credentials are stored with [`conf`](https://github.com/sindresorhus/conf) in your OS's standard config directory.
|
|
37
|
+
|
|
38
|
+
## Quick start
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
# List your projects
|
|
42
|
+
deploylog projects
|
|
43
|
+
|
|
44
|
+
# Publish an entry
|
|
45
|
+
deploylog push \
|
|
46
|
+
--project my-app \
|
|
47
|
+
--title "Dark mode" \
|
|
48
|
+
--body "Auto-detects system preference." \
|
|
49
|
+
--type feature \
|
|
50
|
+
--version 1.4.0 \
|
|
51
|
+
--publish
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Project config
|
|
55
|
+
|
|
56
|
+
Create a `.deploylog.yml` at your repo root so you don't have to pass `--project` every time:
|
|
57
|
+
|
|
58
|
+
```yaml
|
|
59
|
+
project: my-app
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## Commands
|
|
63
|
+
|
|
64
|
+
### `deploylog login`
|
|
65
|
+
|
|
66
|
+
Authenticate with an API key.
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
--key <key> API key (starts with dk_)
|
|
70
|
+
--api-url <url> API base URL (default: https://deploylog.dev)
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### `deploylog logout`
|
|
74
|
+
|
|
75
|
+
Remove stored credentials.
|
|
76
|
+
|
|
77
|
+
### `deploylog projects`
|
|
78
|
+
|
|
79
|
+
List projects in your organization.
|
|
80
|
+
|
|
81
|
+
### `deploylog list`
|
|
82
|
+
|
|
83
|
+
List recent entries for a project.
|
|
84
|
+
|
|
85
|
+
```
|
|
86
|
+
-p, --project <slug> Project slug (or set in .deploylog.yml)
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### `deploylog push`
|
|
90
|
+
|
|
91
|
+
Create a new changelog entry.
|
|
92
|
+
|
|
93
|
+
```
|
|
94
|
+
-t, --title <title> Entry title
|
|
95
|
+
-b, --body <markdown> Entry body (Markdown)
|
|
96
|
+
-p, --project <slug> Project slug (or set in .deploylog.yml)
|
|
97
|
+
--type <type> feature | fix | improvement | breaking | announcement
|
|
98
|
+
--version <version> Semver (e.g. 1.2.3)
|
|
99
|
+
--publish Publish immediately
|
|
100
|
+
--draft Save as draft (default)
|
|
101
|
+
--from-git Derive title/body from commits since the last tag
|
|
102
|
+
--ai-summarize Rewrite the entry with Claude Haiku
|
|
103
|
+
-y, --yes Skip interactive confirmation for AI-generated content
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
## Recipes
|
|
107
|
+
|
|
108
|
+
**Draft from recent commits:**
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
deploylog push --from-git
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Collects commits since the last git tag, formats them as a Markdown list, and opens the entry as a draft.
|
|
115
|
+
|
|
116
|
+
**AI-polished release notes:**
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
deploylog push --from-git --ai-summarize --version 1.4.0 --publish
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
Uses Claude Haiku to rewrite your raw commits into user-friendly release notes. Free plan includes 5 AI summaries per month; paid plans are unlimited.
|
|
123
|
+
|
|
124
|
+
**CI / GitHub Actions:**
|
|
125
|
+
|
|
126
|
+
For CI workflows, prefer the official Action:
|
|
127
|
+
|
|
128
|
+
- [`deploylogdev/action`](https://github.com/marketplace/actions/deploylog) on the GitHub Marketplace
|
|
129
|
+
|
|
130
|
+
## Related
|
|
131
|
+
|
|
132
|
+
- **Dashboard** — [deploylog.dev](https://deploylog.dev)
|
|
133
|
+
- **Widget** — embeddable changelog widget at `cdn.deploylog.dev`
|
|
134
|
+
- **GitHub Action** — [`deploylogdev/action@v1`](https://github.com/marketplace/actions/deploylog)
|
|
135
|
+
|
|
136
|
+
## License
|
|
137
|
+
|
|
138
|
+
MIT © DeployLog
|