mothx-installer 1.1.58__py3-none-win_amd64.whl
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.
- mothx_installer/__init__.py +1 -0
- mothx_installer/__main__.py +4 -0
- mothx_installer/bin/mothx.exe +0 -0
- mothx_installer/cli.py +38 -0
- mothx_installer-1.1.58.dist-info/METADATA +268 -0
- mothx_installer-1.1.58.dist-info/RECORD +9 -0
- mothx_installer-1.1.58.dist-info/WHEEL +5 -0
- mothx_installer-1.1.58.dist-info/entry_points.txt +3 -0
- mothx_installer-1.1.58.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
__version__ = "1.1.58"
|
|
Binary file
|
mothx_installer/cli.py
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import os
|
|
2
|
+
import subprocess
|
|
3
|
+
import sys
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def _binary_name() -> str:
|
|
8
|
+
if sys.platform.startswith("win"):
|
|
9
|
+
return "mothx.exe"
|
|
10
|
+
return "mothx"
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
def _binary_path() -> Path:
|
|
14
|
+
package_dir = Path(__file__).resolve().parent
|
|
15
|
+
preferred = package_dir / "bin" / _binary_name()
|
|
16
|
+
if preferred.is_file():
|
|
17
|
+
return preferred
|
|
18
|
+
legacy = "vibecoding.exe" if sys.platform.startswith("win") else "vibecoding"
|
|
19
|
+
return package_dir / "bin" / legacy
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
def main() -> int:
|
|
23
|
+
binary = _binary_path()
|
|
24
|
+
if not binary.is_file():
|
|
25
|
+
sys.stderr.write("MothX binary is missing from this PyPI installation.\n")
|
|
26
|
+
sys.stderr.write("Reinstall with: pip install --force-reinstall mothx-installer\n")
|
|
27
|
+
return 1
|
|
28
|
+
|
|
29
|
+
args = [str(binary), *sys.argv[1:]]
|
|
30
|
+
if not sys.platform.startswith("win"):
|
|
31
|
+
try:
|
|
32
|
+
os.execv(str(binary), args)
|
|
33
|
+
except OSError as exc:
|
|
34
|
+
sys.stderr.write(f"Failed to execute MothX binary: {exc}\n")
|
|
35
|
+
return 1
|
|
36
|
+
return 1
|
|
37
|
+
|
|
38
|
+
return subprocess.call(args)
|
|
@@ -0,0 +1,268 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: mothx-installer
|
|
3
|
+
Version: 1.1.58
|
|
4
|
+
Summary: AI coding assistant for the terminal
|
|
5
|
+
Author: MothX
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/startvibecoding/mothx
|
|
8
|
+
Project-URL: Repository, https://github.com/startvibecoding/mothx
|
|
9
|
+
Project-URL: Documentation, https://github.com/startvibecoding/mothx/tree/main/docs
|
|
10
|
+
Keywords: ai,coding,assistant,terminal,cli,llm
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Environment :: Console
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: Operating System :: MacOS
|
|
15
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
16
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
17
|
+
Classifier: Programming Language :: Python :: 3
|
|
18
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
19
|
+
Classifier: Topic :: Software Development
|
|
20
|
+
Classifier: Topic :: Terminals
|
|
21
|
+
Requires-Python: >=3.8
|
|
22
|
+
Description-Content-Type: text/markdown
|
|
23
|
+
|
|
24
|
+
> **Rename notice:** VibeCoding is now **MothX**. PyPI install name: `mothx-installer` (`pipx install mothx-installer` or `pip install mothx-installer`).
|
|
25
|
+
|
|
26
|
+
# MothX
|
|
27
|
+
|
|
28
|
+
MothX was formerly known as VibeCoding. Each wheel includes a platform-native `mothx` binary. The `vibecoding` console command is still registered as a compatibility alias during the rename transition.
|
|
29
|
+
|
|
30
|
+
## Installation
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
pip install mothx-installer
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Or with an isolated environment:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
pipx install mothx-installer
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
After installation, the `mothx` command is available on your `PATH`.
|
|
43
|
+
|
|
44
|
+
## Quick Start
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
# Set your API key
|
|
48
|
+
export DEEPSEEK_API_KEY=sk-...
|
|
49
|
+
|
|
50
|
+
# Start an interactive session
|
|
51
|
+
mothx
|
|
52
|
+
|
|
53
|
+
# Or ask a question directly
|
|
54
|
+
mothx -P "Write a Go HTTP server"
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Choose Your Mode
|
|
58
|
+
|
|
59
|
+
Every session runs in one of three modes, switchable anytime with `Tab` or `/mode`:
|
|
60
|
+
|
|
61
|
+
| Mode | Files | Network | Best For |
|
|
62
|
+
|------|-------|---------|----------|
|
|
63
|
+
| **Plan** | Read-only | ✗ | Analysis, code review, safe exploration |
|
|
64
|
+
| **Agent** | Read/Write | ✗ | Daily development (default) |
|
|
65
|
+
| **YOLO** | Full | ✓ | System administration, automation |
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
mothx --mode plan # read-only
|
|
69
|
+
mothx --mode agent # standard (default)
|
|
70
|
+
mothx --mode yolo # full access
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## Multi-Provider Support
|
|
74
|
+
|
|
75
|
+
Switch providers with a single flag:
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
# DeepSeek (default)
|
|
79
|
+
mothx --provider deepseek-openai --model deepseek-v4-flash
|
|
80
|
+
|
|
81
|
+
# OpenAI
|
|
82
|
+
mothx --provider openai --model gpt-4o
|
|
83
|
+
|
|
84
|
+
# Anthropic
|
|
85
|
+
mothx --provider anthropic --model claude-3-5-sonnet-20241022
|
|
86
|
+
|
|
87
|
+
# 20+ vendor adapters supported: Gemini, Kimi, Volcengine, Mistral,
|
|
88
|
+
# OpenRouter, Groq, Bedrock, GitHub Copilot, and more
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Session Management
|
|
92
|
+
|
|
93
|
+
MothX persists conversation history in SQLite with branching support:
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
mothx # start new session
|
|
97
|
+
mothx --continue # resume last session
|
|
98
|
+
mothx --resume <id> # resume a specific session
|
|
99
|
+
mothx --session <file> # open a specific session file
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Sessions live in `~/.mothx/sessions/` (Linux/macOS) or `%APPDATA%\mothx\sessions\` (Windows).
|
|
103
|
+
|
|
104
|
+
## Print / CI Mode
|
|
105
|
+
|
|
106
|
+
Use MothX in non-interactive mode for scripting and CI/CD:
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
mothx -P "Write unit tests for auth.go"
|
|
110
|
+
mothx -P "Generate a CHANGELOG from git log" > CHANGELOG.md
|
|
111
|
+
echo "Explain this function" | mothx -P
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Use `--mode plan` for read-only tasks and pair with `--print` to fail fast when approval is required.
|
|
115
|
+
|
|
116
|
+
## Think Mode
|
|
117
|
+
|
|
118
|
+
Enable deeper reasoning for complex problems:
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
mothx --thinking high "Solve this architecture problem"
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
Levels: `off`, `minimal`, `low`, `medium`, `high`, `xhigh` — toggle in TUI with `/think`.
|
|
125
|
+
|
|
126
|
+
## Security & Sandboxing
|
|
127
|
+
|
|
128
|
+
MothX uses [bubblewrap](https://github.com/containers/bubblewrap) for process-level isolation. Three layers of protection:
|
|
129
|
+
|
|
130
|
+
- **Blacklist** — dangerous commands (`rm -rf`, `sudo`) are always blocked, even in YOLO mode
|
|
131
|
+
- **Approval gates** — Agent mode prompts before executing bash commands
|
|
132
|
+
- **Whitelist** — pre-approve safe commands in `settings.json`:
|
|
133
|
+
|
|
134
|
+
```json
|
|
135
|
+
{
|
|
136
|
+
"approval": {
|
|
137
|
+
"bashWhitelist": ["go ", "make ", "git ", "npm "],
|
|
138
|
+
"bashBlacklist": ["rm -rf", "sudo"],
|
|
139
|
+
"confirmBeforeWrite": true
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
## Skills System
|
|
145
|
+
|
|
146
|
+
Skills are reusable prompt snippets for project conventions:
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
# List skills
|
|
150
|
+
> /skills
|
|
151
|
+
|
|
152
|
+
# Activate a skill
|
|
153
|
+
> /skill my-conventions
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
Place `SKILL.md` files in:
|
|
157
|
+
- **Global** — `~/.mothx/skills/<name>/SKILL.md`
|
|
158
|
+
- **Project** — `.skills/<name>/SKILL.md` (overrides global)
|
|
159
|
+
|
|
160
|
+
Compatible with [SkillHub](https://github.com/startvibecoding/skillhub) for discovering and sharing community skills.
|
|
161
|
+
|
|
162
|
+
## IDE Integration
|
|
163
|
+
|
|
164
|
+
MothX speaks [Agent Client Protocol (ACP)](https://github.com/startvibecoding/mothx/blob/main/docs/en/acp.md), integrating with VS Code, Zed, and JetBrains IDEs.
|
|
165
|
+
|
|
166
|
+
### VS Code
|
|
167
|
+
|
|
168
|
+
Add to `.vscode/settings.json`:
|
|
169
|
+
|
|
170
|
+
```json
|
|
171
|
+
{
|
|
172
|
+
"acp.agents": {
|
|
173
|
+
"mothx": {
|
|
174
|
+
"command": "mothx",
|
|
175
|
+
"args": ["acp", "--mode", "agent"]
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
### JetBrains (IntelliJ, WebStorm, etc.)
|
|
182
|
+
|
|
183
|
+
Go to `Settings → Tools → ACP Agents` and add:
|
|
184
|
+
- Name: `MothX`
|
|
185
|
+
- Command: `mothx`
|
|
186
|
+
- Arguments: `acp --mode agent`
|
|
187
|
+
|
|
188
|
+
## Gateway Mode
|
|
189
|
+
|
|
190
|
+
Run MothX as an OpenAI-compatible HTTP server:
|
|
191
|
+
|
|
192
|
+
```bash
|
|
193
|
+
mothx gateway
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
Config in `~/.mothx/gateway.json` or `.mothx/gateway.json`. Ideal for team sharing, CI/CD pipelines, and embedding into your own tools.
|
|
197
|
+
|
|
198
|
+
## Multi-Agent Mode
|
|
199
|
+
|
|
200
|
+
Enable sub-agent delegation and cron workflows:
|
|
201
|
+
|
|
202
|
+
```bash
|
|
203
|
+
mothx --multi-agent
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
Sub-agent tools: `subagent_spawn`, `subagent_status`, `subagent_send`, `subagent_destroy`.
|
|
207
|
+
|
|
208
|
+
For a single blocking investigation:
|
|
209
|
+
|
|
210
|
+
```bash
|
|
211
|
+
mothx --delegate
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
## Hermes / Messaging Mode
|
|
215
|
+
|
|
216
|
+
Deploy MothX as a chatbot on WeChat, Feishu, or WebSocket:
|
|
217
|
+
|
|
218
|
+
```bash
|
|
219
|
+
mothx hermes
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
Config in `~/.mothx/hermes.json`. Each user gets an independent, persistent session.
|
|
223
|
+
|
|
224
|
+
## Keyboard Shortcuts
|
|
225
|
+
|
|
226
|
+
| Shortcut | Action |
|
|
227
|
+
|----------|--------|
|
|
228
|
+
| `Enter` | Submit prompt |
|
|
229
|
+
| `Alt+Enter` / `Ctrl+J` | Insert newline |
|
|
230
|
+
| `Tab` | Cycle mode (plan → agent → yolo) |
|
|
231
|
+
| `Esc` | Abort current operation |
|
|
232
|
+
| `Ctrl+O` | Open tool details |
|
|
233
|
+
| `Ctrl+G` | Toggle compact display |
|
|
234
|
+
| `Ctrl+T` | Toggle thinking display |
|
|
235
|
+
|
|
236
|
+
## Supported Platforms
|
|
237
|
+
|
|
238
|
+
- Linux x86_64, arm64, ppc64le, s390x
|
|
239
|
+
- Linux musl x86_64, arm64
|
|
240
|
+
- macOS x86_64, arm64
|
|
241
|
+
- Windows x64, arm64
|
|
242
|
+
|
|
243
|
+
Other platforms (LoongArch64, RISC-V64, *BSD) are available via `npm install -g mothx-installer` or the one-line installer.
|
|
244
|
+
|
|
245
|
+
## Diagnostics
|
|
246
|
+
|
|
247
|
+
```bash
|
|
248
|
+
mothx doctor
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
Checks config files, API connections, sandbox, MCP servers, sessions, and skills.
|
|
252
|
+
|
|
253
|
+
## Uninstall
|
|
254
|
+
|
|
255
|
+
```bash
|
|
256
|
+
pip uninstall mothx-installer
|
|
257
|
+
|
|
258
|
+
# or if you used pipx:
|
|
259
|
+
pipx uninstall mothx-installer
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
## Links
|
|
263
|
+
|
|
264
|
+
- **Homepage** — <https://github.com/startvibecoding/mothx>
|
|
265
|
+
- **Documentation** — <https://github.com/startvibecoding/mothx/tree/main/docs>
|
|
266
|
+
- **Changelog** — <https://github.com/startvibecoding/mothx/blob/main/docs/en/changelog.md>
|
|
267
|
+
- **Issues** — <https://github.com/startvibecoding/mothx/issues>
|
|
268
|
+
- **License** — MIT
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
mothx_installer/__init__.py,sha256=nIF6cncwxpxGbGl0tgaAsQ2_dFLR1peCTtDgtBBqIFU,23
|
|
2
|
+
mothx_installer/__main__.py,sha256=D31U8_ux95qF64EQ8ReT25nabzxh7ped5avpobXz_bM,49
|
|
3
|
+
mothx_installer/cli.py,sha256=1LiyJXZG29Kc42T95NBiNZmoAW4q9T97ycYwByrLI0Y,1069
|
|
4
|
+
mothx_installer/bin/mothx.exe,sha256=1GIhptEbJbsCEEBklWxWfRpXh_bOYszob9KIPoJ2x04,7990272
|
|
5
|
+
mothx_installer-1.1.58.dist-info/METADATA,sha256=sLHtzbhBlD292Gnbcbax18n6vvHOUD9bfvV2g-qQClM,6883
|
|
6
|
+
mothx_installer-1.1.58.dist-info/WHEEL,sha256=GjDPPQwEcripVP6P2r3RxLa-h5Lb9ifGB7FYYtbLDT0,98
|
|
7
|
+
mothx_installer-1.1.58.dist-info/entry_points.txt,sha256=yxdu6SMjQttQCPags-6_LaEQtx6bFwux4qKSP76jO7g,89
|
|
8
|
+
mothx_installer-1.1.58.dist-info/top_level.txt,sha256=U1XwzM5k0piOI6NtfjZIic5LNNWiTrv6kFFjCPyDqJ0,16
|
|
9
|
+
mothx_installer-1.1.58.dist-info/RECORD,,
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
mothx_installer
|