snow-ai 0.4.31 → 0.4.33
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/LICENSE +121 -0
- package/README.md +308 -0
- package/bundle/cli.mjs +20996 -6558
- package/package.json +1 -4
- package/readme.md +0 -145
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "snow-ai",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.33",
|
|
4
4
|
"description": "Intelligent Command Line Assistant powered by AI",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"bin": {
|
|
@@ -125,8 +125,5 @@
|
|
|
125
125
|
"prettier": "@vdemedes/prettier-config",
|
|
126
126
|
"optionalDependencies": {
|
|
127
127
|
"sharp": "^0.34.5"
|
|
128
|
-
},
|
|
129
|
-
"dependencies": {
|
|
130
|
-
"cli-table3": "^0.6.5"
|
|
131
128
|
}
|
|
132
129
|
}
|
package/readme.md
DELETED
|
@@ -1,145 +0,0 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
<img src="docs/images/logo.png" alt="Snow AI CLI Logo" width="200"/>
|
|
4
|
-
|
|
5
|
-
# snow-ai
|
|
6
|
-
|
|
7
|
-
**English** | [中文](readme_zh.md)
|
|
8
|
-
|
|
9
|
-
_An intelligent AI-powered CLI tool for developers_
|
|
10
|
-
|
|
11
|
-
</div>
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
## Requirements
|
|
16
|
-
|
|
17
|
-
- **Node.js >= 16.x** (Required for ES2020 features)
|
|
18
|
-
- npm >= 8.3.0
|
|
19
|
-
|
|
20
|
-
### Check Your Node.js Version
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
$ node --version
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
If your version is below 16.x, please upgrade:
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
# Using nvm (recommended)
|
|
30
|
-
$ nvm install 16
|
|
31
|
-
$ nvm use 16
|
|
32
|
-
|
|
33
|
-
# Or download from official website
|
|
34
|
-
# https://nodejs.org/
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## Installation
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
$ npm install -g snow-ai
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
You can also clone and build from source: https://github.com/MayDay-wpf/snow-cli
|
|
44
|
-
|
|
45
|
-
### Install VSCode Extension
|
|
46
|
-
|
|
47
|
-
- Download [snow-cli-x.x.x.vsix](https://github.com/MayDay-wpf/snow-cli/releases/tag/vsix)
|
|
48
|
-
|
|
49
|
-
- Open VSCode, click `Extensions` -> `Install from VSIX...` -> select `snow-cli-0.2.6.vsix`
|
|
50
|
-
|
|
51
|
-
### Install JetBrains Plugin
|
|
52
|
-
|
|
53
|
-
- Download [JetBrains/build/distributions](https://github.com/MayDay-wpf/snow-cli/tree/main/JetBrains/build/distributions)
|
|
54
|
-
|
|
55
|
-
## Available Commands
|
|
56
|
-
|
|
57
|
-
- **Start**: `$ snow`
|
|
58
|
-
- **Update**: `$ snow --update`
|
|
59
|
-
- **Version**: `$ snow --version`
|
|
60
|
-
- **Resume**: `$ snow -c` - Restore the latest conversation history (fully compatible with Claude Code)
|
|
61
|
-
|
|
62
|
-
## API & Model Settings
|
|
63
|
-
|
|
64
|
-
In version `v0.3.2` and later, all official SDKs have been removed (they were too heavy), so the configuration is slightly different. After starting, enter `API & Model Settings` to see the following options:
|
|
65
|
-
|
|
66
|
-
- **Profile** - Switch or create new configurations. Snow now supports saving multiple API and model schemes
|
|
67
|
-
- **Base URL** - Request endpoint. Since official SDKs were removed, OpenAI and Anthropic require `/v1` suffix, Gemini requires `/v1beta`
|
|
68
|
-
- **API Key** - Your API key
|
|
69
|
-
- **Request Method** - Choose based on your needs: `Chat Completions`, `Responses`, `Gemini`, or `Anthropic`
|
|
70
|
-
- **Anthropic Beta** - When checked, Anthropic requests will automatically include `beta=true` parameter
|
|
71
|
-
- **Advanced Model**, **Basic Model**, **Compact Model** - Set the high-performance model for tasks, small model for summarization, and compact model for context compression. All three models use the configured `BaseURL` and `API Key`. The system automatically fetches available models from the `/models` endpoint with filtering support. For APIs with incomplete model lists, use `Manual Input (Enter model name)` to specify the model name
|
|
72
|
-
- **Max Context Tokens** - The model's maximum context window, used for calculating context percentage. For example, Gemini typically has 1M context, so enter `1000000`. This parameter only affects UI calculations, not actual model context
|
|
73
|
-
- **Max Tokens** - This is critical and will be directly added to API requests as the `max_tokens` parameter
|
|
74
|
-
|
|
75
|
-

|
|
76
|
-
|
|
77
|
-
## Proxy & Browser Settings
|
|
78
|
-
|
|
79
|
-
Configure system proxy port and search engine for web search. In most cases, this doesn't need modification as the app will automatically use system proxy. The app automatically detects available search engines (Edge/Chrome) unless you've manually changed their installation paths.
|
|
80
|
-
|
|
81
|
-

|
|
82
|
-
|
|
83
|
-
## System Prompt Settings
|
|
84
|
-
|
|
85
|
-
Customize your system prompt. Note that this supplements Snow's built-in system prompt rather than replacing it. When you set a custom system prompt, Snow's default prompt is downgraded to a user message and appended to the first user message. On Windows, the app automatically opens Notepad; on macOS/Linux, it uses the system's default terminal text editor. After editing and saving, Snow will close and prompt you to restart: `Custom system prompt saved successfully! Please use 'snow' to restart!`
|
|
86
|
-
|
|
87
|
-
## Custom Headers Settings
|
|
88
|
-
|
|
89
|
-
Add custom request headers. Note that you can only add headers, not override Snow's built-in headers.
|
|
90
|
-
|
|
91
|
-
## MCP Settings
|
|
92
|
-
|
|
93
|
-
Configure MCP services. The method is identical to setting system prompts, and the JSON format matches Cursor's format.
|
|
94
|
-
|
|
95
|
-
## Getting Started - Start Conversation
|
|
96
|
-
|
|
97
|
-
Once everything is configured, enter the conversation page by clicking `Start`.
|
|
98
|
-
|
|
99
|
-
- If you launch Snow from VSCode or other editors, Snow will automatically connect to the IDE using the `Snow CLI` plugin. You'll see a connection message. The plugins are published online - search for `Snow CLI` in the plugin marketplace to install.
|
|
100
|
-
|
|
101
|
-

|
|
102
|
-
|
|
103
|
-
### File Selection & Commands
|
|
104
|
-
|
|
105
|
-
- Use `@` to select files. In VSCode, you can also hold `Shift` and drag files for the same effect
|
|
106
|
-
- Use `/` to view available commands:
|
|
107
|
-
- `/init` - Build project documentation `AGENTS.md`
|
|
108
|
-
- `/clear` - Create a new session
|
|
109
|
-
- `/resume` - Restore conversation history
|
|
110
|
-
- `/mcp` - Check MCP connection status and reconnect
|
|
111
|
-
- `/yolo` - Unattended mode (all tool calls execute without confirmation - use with caution)
|
|
112
|
-
- `/ide` - Manually connect to IDE (usually automatic if plugin is installed)
|
|
113
|
-
- `/compact` - Compress context (rarely used as compression reduces AI quality)
|
|
114
|
-
|
|
115
|
-
### Keyboard Shortcuts
|
|
116
|
-
|
|
117
|
-
- **Windows**: `Alt+V` - Paste image; **macOS/Linux**: `Ctrl+V` - Paste image (with prompt)
|
|
118
|
-
- `Ctrl+L` - Clear input from cursor position to the left
|
|
119
|
-
- `Ctrl+R` - Clear input from cursor position to the right
|
|
120
|
-
- `Shift+Tab` - Toggle Yolo mode on/off
|
|
121
|
-
- `ESC` - Stop AI generation
|
|
122
|
-
- **Double-click `ESC`** - Rollback conversation (with file checkpoints)
|
|
123
|
-
|
|
124
|
-
### Token Usage
|
|
125
|
-
|
|
126
|
-
The input area displays context usage percentage, token count, cache hit tokens, and cache creation tokens.
|
|
127
|
-
|
|
128
|
-

|
|
129
|
-
|
|
130
|
-
## Snow System Files
|
|
131
|
-
|
|
132
|
-
All Snow files are stored in the `.snow` folder in your user directory. Here's what each file/folder contains:
|
|
133
|
-
|
|
134
|
-

|
|
135
|
-
|
|
136
|
-
- **log** - Runtime logs (not uploaded anywhere, kept locally for debugging). Safe to delete
|
|
137
|
-
- **profiles** - Multiple configuration files for switching between different API/model setups
|
|
138
|
-
- **sessions** - All conversation history (required for `/resume` and other features, not uploaded)
|
|
139
|
-
- **snapshots** - File snapshots before AI edits (used for rollback). Automatic management, no manual intervention needed
|
|
140
|
-
- **todo** - Persisted todo lists from each conversation (prevents AI from forgetting tasks if app exits unexpectedly)
|
|
141
|
-
- **active-profile.txt** - Identifies the currently active profile (for backward compatibility with early versions)
|
|
142
|
-
- **config.json** - Main API configuration file
|
|
143
|
-
- **custom-headers.json** - Custom request headers
|
|
144
|
-
- **mcp-config.json** - MCP service configuration
|
|
145
|
-
- **system-prompt.txt** - Custom system prompt content
|