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.
@@ -0,0 +1 @@
1
+ __version__ = "1.1.58"
@@ -0,0 +1,4 @@
1
+ from .cli import main
2
+
3
+
4
+ raise SystemExit(main())
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,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (82.0.1)
3
+ Root-Is-Purelib: false
4
+ Tag: py3-none-win_amd64
5
+
@@ -0,0 +1,3 @@
1
+ [console_scripts]
2
+ mothx = mothx_installer.cli:main
3
+ vibecoding = mothx_installer.cli:main
@@ -0,0 +1 @@
1
+ mothx_installer