snowcode 0.9.0 → 0.9.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 +94 -7
- package/dist/cli.mjs +366 -190
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -1,19 +1,103 @@
|
|
|
1
1
|
# Snowcode
|
|
2
2
|
|
|
3
|
-
Snowcode is a multi-provider coding CLI.
|
|
3
|
+
Snowcode is a multi-provider coding CLI focused on real coding workflows, provider switching, and config-first setup.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
It keeps the Claude Code style terminal experience, but lets you use other providers and models such as Codex/OpenAI, Anthropic, Gemini, Vertex, Ollama, and Z.AI.
|
|
6
6
|
|
|
7
|
-
Install
|
|
7
|
+
## Install
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npm install -g snowcode
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
After install, both commands are available:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
11
16
|
snowcode
|
|
17
|
+
snowcode-dev
|
|
12
18
|
```
|
|
13
19
|
|
|
14
|
-
|
|
20
|
+
## Quick Start
|
|
21
|
+
|
|
22
|
+
1. Start the CLI:
|
|
15
23
|
|
|
16
24
|
```bash
|
|
25
|
+
snowcode
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
2. Add an account:
|
|
29
|
+
|
|
30
|
+
```text
|
|
31
|
+
/auth
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
3. Pick a model:
|
|
35
|
+
|
|
36
|
+
```text
|
|
37
|
+
/model
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
4. Start coding in the current folder.
|
|
41
|
+
|
|
42
|
+
## Model Format
|
|
43
|
+
|
|
44
|
+
Snowcode supports provider-scoped model names in the format:
|
|
45
|
+
|
|
46
|
+
```text
|
|
47
|
+
provider:model
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Examples:
|
|
51
|
+
|
|
52
|
+
```text
|
|
53
|
+
codex:gpt-5.4
|
|
54
|
+
codex:gpt-5.1-codex-mini
|
|
55
|
+
anthropic:claude-sonnet-4-6
|
|
56
|
+
vertex:claude-sonnet-4-6
|
|
57
|
+
antigravity:gemini-3.1-pro
|
|
58
|
+
zai:glm-4.5
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
The provider decides transport, auth, endpoint, and provider-specific request formatting.
|
|
62
|
+
|
|
63
|
+
## Config Files
|
|
64
|
+
|
|
65
|
+
Snowcode stores user data in `~/.snowcode/`.
|
|
66
|
+
|
|
67
|
+
Common files:
|
|
68
|
+
|
|
69
|
+
- `~/.snowcode/settings.json` — user settings
|
|
70
|
+
- `~/.snowcode/accounts.json` — authenticated provider accounts
|
|
71
|
+
- `~/.snowcode/models.json` — custom model list / provider model definitions
|
|
72
|
+
|
|
73
|
+
Project-specific settings can also live in:
|
|
74
|
+
|
|
75
|
+
- `.claude/settings.json`
|
|
76
|
+
- `.claude/settings.local.json`
|
|
77
|
+
|
|
78
|
+
## Example Settings
|
|
79
|
+
|
|
80
|
+
```json
|
|
81
|
+
{
|
|
82
|
+
"model": "codex:gpt-5.4",
|
|
83
|
+
"compactModel": "openai:gpt-4o-mini",
|
|
84
|
+
"autoCompactWindowTokens": 120000
|
|
85
|
+
}
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## Useful Commands
|
|
89
|
+
|
|
90
|
+
- `/auth` — add or manage provider accounts
|
|
91
|
+
- `/model` — switch models
|
|
92
|
+
- `/effort`, `/reasoning`, `/thinking` — provider/model-specific inference controls
|
|
93
|
+
- `/compact` — compact conversation context
|
|
94
|
+
- `/usage` — inspect provider usage pages
|
|
95
|
+
- `/config` — inspect or update settings
|
|
96
|
+
|
|
97
|
+
## Local Development
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
bun install
|
|
17
101
|
bun run build
|
|
18
102
|
node dist/cli.mjs
|
|
19
103
|
```
|
|
@@ -24,9 +108,12 @@ Useful scripts:
|
|
|
24
108
|
npm run install:global
|
|
25
109
|
npm run link:global
|
|
26
110
|
npm run unlink:global
|
|
111
|
+
bun run test:provider
|
|
112
|
+
bun run build
|
|
27
113
|
```
|
|
28
114
|
|
|
29
|
-
##
|
|
115
|
+
## Notes
|
|
30
116
|
|
|
31
|
-
-
|
|
32
|
-
-
|
|
117
|
+
- `/login` is kept as an alias for `/auth`.
|
|
118
|
+
- Codex auth can refresh from the Snowcode account store when the local Codex token is stale.
|
|
119
|
+
- The main documentation flow is config-first. Prefer `settings.json` and `/config` over ad-hoc env setup.
|