cliff-ai 1.0.0 → 1.0.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.
Files changed (3) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +28 -49
  3. package/package.json +2 -2
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Raj Shah
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -39,87 +39,66 @@ A terminal-first AI coding assistant built with **Node.js, Groq, LangChain, and
39
39
 
40
40
  ### A quick look at the workflow
41
41
 
42
- ```text
43
- $ cliff
44
-
45
- CLIFF.
46
- THE EDGE IS YOURS.
47
-
48
- > Read calculator.js and add input validation to multiply().
49
-
50
- ◇ Reading calculator.js
51
- ◇ Preparing an edit
52
-
53
- Proposed changes: calculator.js
54
- ─────────────────────────────────────────
55
- - return a * b;
56
- + if (typeof a !== "number" || typeof b !== "number") {
57
- + throw new TypeError("Expected numbers");
58
- + }
59
- + return a * b;
60
-
61
- Apply this change? [y/N] y
62
- ✓ File updated
63
- ```
42
+ ![CLI Screenshot](https://ik.imagekit.io/hqhsgjeub/clif/image.png)
64
43
 
65
44
  <sub>Illustrative terminal session; exact visual output depends on the current CLI UI.</sub>
66
45
 
67
- ## 🚀 Getting started
46
+
47
+ ## 🚀 Getting Started
68
48
 
69
49
  ### Prerequisites
70
50
 
71
- - A recent Node.js version and npm
72
- - A [Groq API key](https://console.groq.com/keys)
73
- - A terminal and a project folder to work in
51
+ - **Node.js** (v20 or later recommended)
52
+ - A free [Groq API Key](https://console.groq.com/keys)
53
+ - A terminal and a project to work on
54
+
55
+ ### 1. Install CLIFF
74
56
 
75
- ### 1. Clone and install
57
+ Install globally using npm:
76
58
 
77
59
  ```bash
78
- git clone <YOUR_REPOSITORY_URL>
79
- cd <YOUR_REPOSITORY_FOLDER>
80
- npm install
60
+ npm install -g cliff-ai
81
61
  ```
82
62
 
83
- ### 2. Link CLIFF as a local CLI command
63
+ Or run directly without installing:
84
64
 
85
65
  ```bash
86
- npm link
66
+ npx cliff-ai
87
67
  ```
88
68
 
89
- This makes the CLI command available globally **on your machine** from the local repository. It does not publish CLIFF to npm.
69
+ ### 2. Launch CLIFF
90
70
 
91
- ### 3. Open the project you want to work on
71
+ Navigate to your project directory and start CLIFF:
92
72
 
93
73
  ```bash
94
74
  cd path/to/your/project
95
75
  cliff
96
76
  ```
97
77
 
98
- On first launch, follow CLIFF's setup prompts to configure your Groq API key and model. Configuration is stored locally in CLIFF's settings file.
78
+ On your first launch, CLIFF will guide you through configuring your **Groq API key** and selecting an AI model.
99
79
 
100
80
  > [!IMPORTANT]
101
- > Run CLIFF **inside the project directory** you intend to work on. CLIFF uses the current working directory as its workspace. Review every proposed write before approving it, and avoid using real secrets or irreplaceable files while testing.
81
+ > Always launch CLIFF **inside your project directory**. CLIFF treats the current working directory as its workspace. Review file modifications before approving them.
102
82
 
103
- ### Try these prompts
83
+ ### 3. Start Building ✨
104
84
 
105
- ```text
106
- Read README.md and summarize the project's structure.
107
- ```
85
+ Try asking CLIFF:
108
86
 
109
87
  ```text
110
- Create a utils.js file with a function that validates an email address.
111
- ```
88
+ > Read README.md and explain this project.
112
89
 
113
- ```text
114
- Read calculator.js and update only the multiply function to reject non-number inputs.
115
- ```
90
+ > Create a utils.js file with an email validation function.
116
91
 
117
- ```text
118
- List the files in the current directory and tell me where the entry point might be.
92
+ > Update the multiply function in calculator.js to handle invalid inputs.
93
+
94
+ > List all files and identify the project's entry point.
119
95
  ```
120
96
 
121
- > [!NOTE]
122
- > Available slash commands and model names can depend on your current CLIFF build. Use the in-app help command, if available, for the authoritative list.
97
+ ### 🔗 Useful Links
98
+
99
+ [![npm](https://img.shields.io/npm/v/cliff-ai?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/cliff-ai)
100
+
101
+ > **CLIFF v1** focuses on reading, creating, and updating project files with AI-powered assistance and user-controlled approvals.
123
102
 
124
103
  ## 🧰 Tech stack
125
104
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cliff-ai",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "CLIFF — An AI-powered terminal coding assistant. The edge is yours.",
5
5
  "main": "index.js",
6
6
  "bin": {
@@ -18,7 +18,7 @@
18
18
  "README.md",
19
19
  "LICENSE"
20
20
  ],
21
- "keywords": [
21
+ "keywords": [
22
22
  "cliff",
23
23
  "ai",
24
24
  "coding-assistant",