Skip to content

Commit 4863478

Browse files
authored
Refactor CLI command names from 'penifycli' to 'penify' for consisten… (#74)
* Refactor CLI command names from 'penifycli' to 'penify' for consistency across documentation and codebase * Bump version to 0.3.0 for release
1 parent 5ad807b commit 4863478

File tree

11 files changed

+120
-120
lines changed

11 files changed

+120
-120
lines changed

README.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ A CLI tool to generate smart commit messages, code documentation, and more.
1717
Install from PyPI:
1818

1919
```bash
20-
pip install penifycli
20+
pip install penify
2121
```
2222

2323
## Usage
@@ -31,7 +31,7 @@ Penify CLI provides several subcommands for different functionalities, organized
3131
Generate smart commit messages using local LLM:
3232

3333
```bash
34-
penifycli commit [-m "Optional message"] [-e] [-d]
34+
penify commit [-m "Optional message"] [-e] [-d]
3535
```
3636

3737
Options:
@@ -45,16 +45,16 @@ Configure local LLM and JIRA settings:
4545

4646
```bash
4747
# Configure LLM settings
48-
penifycli config llm --model MODEL_NAME [--api-base API_URL] [--api-key API_KEY]
48+
penify config llm --model MODEL_NAME [--api-base API_URL] [--api-key API_KEY]
4949

5050
# Configure LLM settings through web interface
51-
penifycli config llm-web
51+
penify config llm-web
5252

5353
# Configure JIRA settings
54-
penifycli config jira --url JIRA_URL --username USERNAME --api-token TOKEN [--verify]
54+
penify config jira --url JIRA_URL --username USERNAME --api-token TOKEN [--verify]
5555

5656
# Configure JIRA settings through web interface
57-
penifycli config jira-web
57+
penify config jira-web
5858
```
5959

6060
## Advanced Commands (Login required)
@@ -64,7 +64,7 @@ penifycli config jira-web
6464
To log in and obtain an API token:
6565

6666
```bash
67-
penifycli login
67+
penify login
6868
```
6969

7070
This command will open a browser window for authentication. After successful login, the API key will be saved locally for future use.
@@ -75,10 +75,10 @@ Generate documentation for Git diff, files or folders:
7575

7676
```bash
7777
# Generate documentation for latest Git commit diff
78-
penifycli docgen
78+
penify docgen
7979

8080
# Generate documentation for specific file or folder
81-
penifycli docgen -l /path/to/file/or/folder
81+
penify docgen -l /path/to/file/or/folder
8282
```
8383

8484
Options:
@@ -90,10 +90,10 @@ Install or uninstall Git post-commit hooks:
9090

9191
```bash
9292
# Install Git hook
93-
penifycli docgen install-hook [-l /path/to/repo]
93+
penify docgen install-hook [-l /path/to/repo]
9494

9595
# Uninstall Git hook
96-
penifycli docgen uninstall-hook [-l /path/to/repo]
96+
penify docgen uninstall-hook [-l /path/to/repo]
9797
```
9898

9999
Options:
@@ -110,7 +110,7 @@ If no token is available and you try to access an advanced feature, you'll be pr
110110
For commit message generation, Penify can use a local LLM. Configure it using:
111111

112112
```bash
113-
penifycli config llm --model MODEL_NAME --api-base API_URL --api-key API_KEY
113+
penify config llm --model MODEL_NAME --api-base API_URL --api-key API_KEY
114114
```
115115

116116
Common configurations:
@@ -122,7 +122,7 @@ Common configurations:
122122
Configure JIRA integration to enhance commit messages with issue details:
123123

124124
```bash
125-
penifycli config jira --url https://your-domain.atlassian.net --username [email protected] --api-token YOUR_API_TOKEN
125+
penify config jira --url https://your-domain.atlassian.net --username [email protected] --api-token YOUR_API_TOKEN
126126
```
127127

128128
## Development
@@ -159,7 +159,7 @@ Contributions are welcome! Please feel free to submit a Pull Request.
159159

160160
## Issues
161161

162-
If you encounter any problems or have suggestions, please file an issue on the [GitHub repository](https://github.com/SingularityX-ai/penifycli/issues).
162+
If you encounter any problems or have suggestions, please file an issue on the [GitHub repository](https://github.com/SingularityX-ai/penify/issues).
163163

164164
## Support
165165

docs/commit-commands.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ The `commit` command allows you to generate smart, AI-powered commit messages fo
55
## Basic Usage
66

77
```bash
8-
penifycli commit
8+
penify commit
99
```
1010

1111
By default, this command:
@@ -20,7 +20,7 @@ By default, this command:
2020
Provide context for the commit message generation:
2121

2222
```bash
23-
penifycli commit -m "Fix login flow"
23+
penify commit -m "Fix login flow"
2424
```
2525

2626
This hint helps the AI understand your intention and improves the quality of the generated message.
@@ -30,7 +30,7 @@ This hint helps the AI understand your intention and improves the quality of the
3030
Open an editor to review and edit the generated commit message before committing:
3131

3232
```bash
33-
penifycli commit -e
33+
penify commit -e
3434
```
3535

3636
This opens your default Git editor with the generated message for review.
@@ -40,7 +40,7 @@ This opens your default Git editor with the generated message for review.
4040
Generate a detailed commit message with both title and description:
4141

4242
```bash
43-
penifycli commit -d
43+
penify commit -d
4444
```
4545

4646
Without this flag, only the commit title is generated.
@@ -52,32 +52,32 @@ You can combine these options for different workflows:
5252
### Generate Title Only with Context
5353

5454
```bash
55-
penifycli commit -m "Update login UI"
55+
penify commit -m "Update login UI"
5656
```
5757

5858
### Generate Title and Description with Context
5959

6060
```bash
61-
penifycli commit -m "Update login UI" -d
61+
penify commit -m "Update login UI" -d
6262
```
6363

6464
### Generate and Edit Full Commit Message
6565

6666
```bash
67-
penifycli commit -d -e
67+
penify commit -d -e
6868
```
6969

7070
### Generate, Edit, and Provide Context
7171

7272
```bash
73-
penifycli commit -m "Refactor authentication" -d -e
73+
penify commit -m "Refactor authentication" -d -e
7474
```
7575

7676
## LLM and JIRA Integration
7777

7878
### Using Local LLM
7979

80-
If you've configured a local LLM using `penifycli config llm`, the commit command will automatically use it for message generation.
80+
If you've configured a local LLM using `penify config llm`, the commit command will automatically use it for message generation.
8181

8282
Benefits:
8383
- Privacy: your code changes don't leave your machine
@@ -86,7 +86,7 @@ Benefits:
8686

8787
### JIRA Enhancement
8888

89-
If you've configured JIRA integration using `penifycli config jira`, the commit command will:
89+
If you've configured JIRA integration using `penify config jira`, the commit command will:
9090

9191
1. Detect JIRA issue references in your changes
9292
2. Fetch issue details from your JIRA instance
@@ -109,11 +109,11 @@ PROJ-123: Fix authentication bug in login flow
109109
For the `commit` command to work:
110110

111111
1. You must have configured either:
112-
- Local LLM via `penifycli config llm`, OR
113-
- Logged in via `penifycli login`
112+
- Local LLM via `penify config llm`, OR
113+
- Logged in via `penify login`
114114

115115
2. For JIRA enhancement (optional):
116-
- Configure JIRA via `penifycli config jira`
116+
- Configure JIRA via `penify config jira`
117117

118118
## Examples
119119

@@ -124,7 +124,7 @@ For the `commit` command to work:
124124
git add .
125125

126126
# Generate commit message
127-
penifycli commit
127+
penify commit
128128

129129
# Commit with the generated message
130130
git commit -m "Generated message here"
@@ -138,7 +138,7 @@ git add .
138138

139139
# Generate detailed commit message with JIRA integration,
140140
# provide context, and open editor for review
141-
penifycli commit -m "Fix login issue" -d -e
141+
penify commit -m "Fix login issue" -d -e
142142

143143
# The commit is automatically completed after you save and exit the editor
144144
```
@@ -148,8 +148,8 @@ penifycli commit -m "Fix login issue" -d -e
148148
### Common Issues
149149

150150
1. **"No LLM model or API token provided"**
151-
- Run `penifycli config llm` to configure a local LLM, or
152-
- Run `penifycli login` to authenticate with Penify
151+
- Run `penify config llm` to configure a local LLM, or
152+
- Run `penify login` to authenticate with Penify
153153

154154
2. **"Failed to connect to JIRA"**
155155
- Check your JIRA configuration with `cat ~/.penify`

docs/config-commands.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,17 @@ Penify CLI stores configuration in a JSON file at `~/.penify/config.json`. The c
1414

1515
```bash
1616
# Configure LLM settings
17-
penifycli config llm
17+
penify config llm
1818

1919
# Configure JIRA integration
20-
penifycli config jira
20+
penify config jira
2121
```
2222

2323
## LLM Configuration
2424

2525
### Web Interface
2626

27-
Running `penifycli config llm` opens a web interface in your browser where you can configure:
27+
Running `penify config llm` opens a web interface in your browser where you can configure:
2828

2929
1. **Model**: The LLM model to use (e.g., `gpt-3.5-turbo`)
3030
2. **API Base URL**: The endpoint URL for your LLM API (e.g., `https://api.openai.com/v1`)
@@ -72,7 +72,7 @@ After configuration, your `~/.penify/config.json` will contain:
7272

7373
### Web Interface
7474

75-
Running `penifycli config jira` opens a web interface where you can configure:
75+
Running `penify config jira` opens a web interface where you can configure:
7676

7777
1. **JIRA URL**: Your JIRA instance URL (e.g., `https://yourcompany.atlassian.net`)
7878
2. **Username**: Your JIRA username (typically your email)
@@ -123,7 +123,7 @@ You can override configuration settings using environment variables:
123123
Example:
124124
```bash
125125
export PENIFY_LLM_MODEL="gpt-4"
126-
penifycli commit
126+
penify commit
127127
```
128128

129129
## Command-Line Configuration

docs/detailed-usage.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ This document provides in-depth information about all features and capabilities
3131

3232
### Login Process
3333

34-
When you run `penifycli login`, the tool:
34+
When you run `penify login`, the tool:
3535

3636
1. Opens your default web browser
3737
2. Redirects you to Penify's login page
@@ -58,7 +58,7 @@ API tokens are stored in your home directory in the `.penify` file. This JSON fi
5858
## Command Overview
5959

6060
```
61-
penifycli
61+
penify
6262
├── commit Generate smart commit messages
6363
├── config Configure local LLM and JIRA
6464
│ ├── llm Configure local LLM settings
@@ -91,7 +91,7 @@ The `docgen` command generates documentation for your code:
9191

9292
### Authentication Requirement
9393

94-
This feature requires authentication with a Penify account. Run `penifycli login` before using documentation features.
94+
This feature requires authentication with a Penify account. Run `penify login` before using documentation features.
9595

9696
## Configuration Settings
9797

@@ -108,16 +108,16 @@ Penify can install Git hooks to automate documentation generation:
108108

109109
### Post-Commit Hook
110110

111-
- **Install**: `penifycli docgen install-hook`
111+
- **Install**: `penify docgen install-hook`
112112
- **What it does**: Automatically generates documentation for changed files after each commit
113-
- **Uninstall**: `penifycli docgen uninstall-hook`
113+
- **Uninstall**: `penify docgen uninstall-hook`
114114

115115
### Custom Hook Location
116116

117117
You can specify a custom location for Git hooks:
118118

119119
```bash
120-
penifycli docgen install-hook -l /path/to/git/repo
120+
penify docgen install-hook -l /path/to/git/repo
121121
```
122122

123123
## Advanced Use Cases
@@ -136,14 +136,14 @@ Generate documentation for an entire repository:
136136
```bash
137137
git clone https://github.com/user/repo
138138
cd repo
139-
penifycli docgen -l .
139+
penify docgen -l .
140140
```
141141

142142
## Troubleshooting
143143

144144
### Common Issues
145145

146-
1. **API Key Errors**: Ensure you've run `penifycli login` or set `PENIFY_API_TOKEN`
146+
1. **API Key Errors**: Ensure you've run `penify login` or set `PENIFY_API_TOKEN`
147147
2. **LLM Configuration**: Check your LLM settings with `cat ~/.penify`
148148
3. **JIRA Integration**: Verify JIRA credentials in your configuration
149149

0 commit comments

Comments
 (0)