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.
Files changed (5) hide show
  1. package/LICENSE +121 -0
  2. package/README.md +308 -0
  3. package/bundle/cli.mjs +20996 -6558
  4. package/package.json +1 -4
  5. package/readme.md +0 -145
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "snow-ai",
3
- "version": "0.4.31",
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
- ![alt text](docs/images/image.png)
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
- ![alt text](docs/images/image-1.png)
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
- ![alt text](docs/images/image-2.png)
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
- ![alt text](docs/images/image-3.png)
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
- ![alt text](docs/images/image-4.png)
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