@amethyst-labs/quickcli-linux-arm64 2.0.0-beta.3
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 +122 -0
- package/bin/quick-tui +0 -0
- package/index.js +8 -0
- package/native/build/Release/quickaddon.node +0 -0
- package/native/lib/libquickcore.so +0 -0
- package/package.json +24 -0
package/README.md
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# QuickCLI (`quick`)
|
|
2
|
+
|
|
3
|
+
[](https://github.com/AmethystDev-Labs/QuickCLI/actions/workflows/release.yml)
|
|
4
|
+
[](https://www.npmjs.com/package/@starryskyworld/quickcli)
|
|
5
|
+
[](https://www.npmjs.com/package/@starryskyworld/quickcli)
|
|
6
|
+
[](https://nodejs.org)
|
|
7
|
+
[](https://www.gnu.org/licenses/gpl-3.0)
|
|
8
|
+
|
|
9
|
+
Switch AI coding assistant providers — Claude Code, OpenAI Codex, and OpenCode — with a single command.
|
|
10
|
+
|
|
11
|
+
## Documentation
|
|
12
|
+
|
|
13
|
+
| Guide | Description |
|
|
14
|
+
|---|---|
|
|
15
|
+
| [Installation](docs/installation.md) | npm, pre-built binaries, build from source |
|
|
16
|
+
| [Commands](docs/commands.md) | Full CLI command reference |
|
|
17
|
+
| [Configuration](docs/configuration.md) | Config file schema and what QuickCLI writes |
|
|
18
|
+
| [Templates](docs/templates.md) | Template registry and magic syntax |
|
|
19
|
+
| [TemplateFiles](docs/template-files.md) | Shipping extra Codex config with a template |
|
|
20
|
+
| [Login](docs/login.md) | ChatGPT OAuth browser & device-code flows |
|
|
21
|
+
| [Contributing](docs/contributing.md) | Add templates or contribute code |
|
|
22
|
+
|
|
23
|
+
## Installation
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npm install -g @starryskyworld/quickcli
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Or download a binary directly from [GitHub Releases](https://github.com/AmethystDev-Labs/QuickCLI/releases).
|
|
30
|
+
|
|
31
|
+
## Quick Start
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
# Interactive TUI menu (bare invocation)
|
|
35
|
+
quick
|
|
36
|
+
|
|
37
|
+
# Add a config (interactive TUI wizard)
|
|
38
|
+
quick config add
|
|
39
|
+
|
|
40
|
+
# Add a config with flags
|
|
41
|
+
quick config add privnode \
|
|
42
|
+
--scope codex,claudecode \
|
|
43
|
+
--base-url https://privnode.com/v1 \
|
|
44
|
+
--api-key sk-xxx \
|
|
45
|
+
--model gpt-5-codex
|
|
46
|
+
|
|
47
|
+
# Add a config from a template
|
|
48
|
+
quick config add --from-template openai
|
|
49
|
+
|
|
50
|
+
# Log in with ChatGPT (creates a Codex config automatically)
|
|
51
|
+
quick config login
|
|
52
|
+
quick config login --device # SSH / headless environments
|
|
53
|
+
|
|
54
|
+
# List configs
|
|
55
|
+
quick config list
|
|
56
|
+
|
|
57
|
+
# Activate a config
|
|
58
|
+
quick use privnode
|
|
59
|
+
|
|
60
|
+
# Check current status
|
|
61
|
+
quick status
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
## Commands
|
|
65
|
+
|
|
66
|
+
| Command | Description |
|
|
67
|
+
|---|---|
|
|
68
|
+
| `quick` | Open interactive TUI main menu |
|
|
69
|
+
| `quick config add [name] [flags]` | Add a config (TUI wizard or flags) |
|
|
70
|
+
| `quick config list` | List all configs |
|
|
71
|
+
| `quick config remove <name>` | Remove a config |
|
|
72
|
+
| `quick config login [name]` | Log in with ChatGPT and create a Codex config |
|
|
73
|
+
| `quick template list` | List registry templates |
|
|
74
|
+
| `quick template preview <id>` | Preview a template |
|
|
75
|
+
| `quick use <config-name>` | Activate a config |
|
|
76
|
+
| `quick status` | Show active configuration |
|
|
77
|
+
|
|
78
|
+
## How It Works
|
|
79
|
+
|
|
80
|
+
`quick` writes configuration to:
|
|
81
|
+
|
|
82
|
+
| Tool | Files |
|
|
83
|
+
|---|---|
|
|
84
|
+
| Claude Code | `~/.claude/settings.json` (`env` key) + shell profile |
|
|
85
|
+
| Codex | `~/.codex/config.toml` + `~/.codex/auth.json` + shell profile |
|
|
86
|
+
| OpenCode | `~/.config/opencode/opencode.json` or an existing `*.jsonc` / `*.json` main config in `~/.config/opencode/` |
|
|
87
|
+
|
|
88
|
+
Restart your shell (or `source ~/.zshrc`) after running `quick use` for environment variable changes to take effect.
|
|
89
|
+
|
|
90
|
+
## Config Flags
|
|
91
|
+
|
|
92
|
+
| Flag | Description |
|
|
93
|
+
|---|---|
|
|
94
|
+
| `--scope` | Comma-separated: `codex`, `claudecode`, `opencode` (default: `codex`) |
|
|
95
|
+
| `--base-url` | Provider API base URL |
|
|
96
|
+
| `--api-key` | API key |
|
|
97
|
+
| `--model` | Default model |
|
|
98
|
+
| `--wire-api` | `responses` or `chat` |
|
|
99
|
+
| `--auth-method` | `api_key`, `chatgpt`, `aws`, `gcp`, `azure` |
|
|
100
|
+
| `--from-template` | Template ID (mutually exclusive with manual flags) |
|
|
101
|
+
|
|
102
|
+
## Template Magic Syntax
|
|
103
|
+
|
|
104
|
+
Templates use `${--:"<question>":"<default>"}` placeholders. When you run `quick config add --from-template <id>`, QuickCLI prompts you for each dynamic value:
|
|
105
|
+
|
|
106
|
+
```yaml
|
|
107
|
+
api_key: '${--:"Enter your API Key":""}'
|
|
108
|
+
model: '${--:"Default model":"gpt-5-codex"}'
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Configuration
|
|
112
|
+
|
|
113
|
+
Config is stored at:
|
|
114
|
+
- **Linux/macOS**: `~/.config/quickcli/config.yaml`
|
|
115
|
+
- **Windows**: `%APPDATA%\quickcli\config.yaml`
|
|
116
|
+
|
|
117
|
+
## License
|
|
118
|
+
|
|
119
|
+
GPL-v3
|
|
120
|
+
|
|
121
|
+
## Community
|
|
122
|
+
[Linux.do](https://linux.do)
|
package/bin/quick-tui
ADDED
|
Binary file
|
package/index.js
ADDED
|
Binary file
|
|
Binary file
|
package/package.json
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@amethyst-labs/quickcli-linux-arm64",
|
|
3
|
+
"version": "2.0.0-beta.3",
|
|
4
|
+
"description": "Precompiled QuickCLI runtime for linux-arm64",
|
|
5
|
+
"license": "GPL-3.0-only",
|
|
6
|
+
"os": [
|
|
7
|
+
"linux"
|
|
8
|
+
],
|
|
9
|
+
"cpu": [
|
|
10
|
+
"arm64"
|
|
11
|
+
],
|
|
12
|
+
"files": [
|
|
13
|
+
"native/build/Release/quickaddon.node",
|
|
14
|
+
"native/lib/libquickcore.so",
|
|
15
|
+
"bin/quick-tui",
|
|
16
|
+
"index.js",
|
|
17
|
+
"README.md"
|
|
18
|
+
],
|
|
19
|
+
"main": "index.js",
|
|
20
|
+
"repository": {
|
|
21
|
+
"type": "git",
|
|
22
|
+
"url": "https://github.com/AmethystDev-Labs/QuickCLI.git"
|
|
23
|
+
}
|
|
24
|
+
}
|