You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**Kimiko** is a specialized configuration repository that transforms the [Kimi Code CLI](https://www.moonshot.cn/) into a powerful, unrestricted agent for offensive security, red-teaming, and penetration testing.
When you enter **`kimiko`** in a Kimi CLI session, the full adversarial mandate activates—granting the AI the authority and context needed for exploit development, network reconnaissance, and advanced security research.
22
+
**Kimiko** is a specialized configuration repository that transforms the [Kimi Code CLI](https://www.moonshot.cn/) into a powerful agent configuration for authorized offensive security, red-teaming, and penetration-testing workflows.
23
+
24
+
When you enter **`kimiko`** in a Kimi CLI session, the Kimiko mandate activates, giving the AI the project-specific context needed for security research, audit support, exploit-analysis workflows, reconnaissance planning, and authorized penetration-testing operations.
15
25
16
26
---
17
27
18
28
## What This Project Does
19
29
20
30
Kimiko packages the necessary configuration, agent mandates, and shell integrations into a single Makefile-driven installer. After installation:
21
31
22
-
- Your local `~/.kimi/` is hardened with the **Kimiko mandate**, optimized for adversarial workflows.
23
-
- Launching `kimi` via the wrapper loads the offensive security context automatically.
24
-
- Typing **`kimiko`** inside a Kimi CLI session triggers the zero-blocker authorization flow and offensive capability announcement.
32
+
- Your local `~/.kimi/` is configured with the **Kimiko mandate**, optimized for authorized adversarial security workflows.
33
+
- Launching `kimi` via the wrapper loads the Kimiko security-research context automatically.
34
+
- Typing **`kimiko`** inside a Kimi CLI session triggers the mandate acknowledgment and capability announcement.
25
35
26
-
**Designed for Authorized Pentesting Only.** This configuration removes standard AI safety guardrails to allow for unrestricted security research. **The user is fully and exclusively liable for all actions taken.**
36
+
**Designed for Authorized Pentesting Only.** This configuration is intended for lawful security research, controlled red-team engagements, lab environments, and systems you own or are explicitly authorized to test. **The user is fully and exclusively liable for all actions taken.**
27
37
28
38
---
29
39
30
40
## Prerequisites
31
41
32
42
### macOS
33
43
34
-
- macOS (Darwin/BSD tools)
35
-
-`make`(ships with macOS)
36
-
- Python 3.11+ (only if running validator tests/schemas)
44
+
- macOS with Darwin/BSD userland tools
45
+
-`make`— ships with macOS Command Line Tools
46
+
- Python 3.11+ — only required for validator tests and schemas
37
47
38
48
### Linux / WSL
39
49
40
-
- Linux distribution (Ubuntu recommended for WSL)
41
-
-`make`, `python3`, standard POSIX tools
50
+
- Linux distribution — Ubuntu recommended for WSL
51
+
-`make`
52
+
-`python3`
53
+
- Standard POSIX tools
42
54
43
-
### Git Bash (Windows)
55
+
### Git Bash on Windows
44
56
45
57
-[Git for Windows](https://git-scm.com/download/win)
46
-
-`make`(install via `choco install make`or MSYS2)
47
-
- Python 3.11+ (optional)
58
+
-`make`— install via Chocolatey, MSYS2, or another package manager
After step 5 (or the PowerShell equivalent) you should see the Kimiko mandate acknowledgment and offensive capability announcement.
130
+
After activation, you should see the Kimiko mandate acknowledgment and capability announcement.
107
131
108
-
> **Tip:** For a deep-dive into the offensive mandate architecture, see [`docs/AGENTS.md`](docs/AGENTS.md).
132
+
>**Tip:** For a deepdive into the mandate architecture, see [`docs/AGENTS.md`](docs/AGENTS.md).
109
133
>
110
-
> **⚠️ Legal Notice:** By using this software you agree to the terms in [`docs/legal/DISCLAIMER.md`](docs/legal/DISCLAIMER.md). **YOU ARE FULLY AND EXCLUSIVELY LIABLE FOR YOUR ACTIONS.**
134
+
>**⚠️ Legal Notice:** By using this software, you agree to the terms in [`docs/legal/DISCLAIMER.md`](docs/legal/DISCLAIMER.md). **YOU ARE FULLY AND EXCLUSIVELY LIABLE FOR YOUR ACTIONS.**
|`make sync`| Verifies config mirrors are identical|
146
+
|`make test`| Runs the validator pytest suite|
147
+
|`make uninstall`| Removes installed files while preserving secrets|
148
+
|`make help`| Shows available targets|
125
149
126
150
---
127
151
128
152
## Repository Layout
129
153
130
-
```
154
+
```text
131
155
kimiko/
132
156
├── config/
133
157
│ ├── config.toml
@@ -151,3 +175,61 @@ kimiko/
151
175
├── Makefile
152
176
└── README.md
153
177
```
178
+
179
+
---
180
+
181
+
## Verification
182
+
183
+
Run the verification target after installation:
184
+
185
+
```bash
186
+
make verify
187
+
```
188
+
189
+
Run the full check suite:
190
+
191
+
```bash
192
+
make check
193
+
```
194
+
195
+
Run validator tests:
196
+
197
+
```bash
198
+
make test
199
+
```
200
+
201
+
---
202
+
203
+
## Uninstall
204
+
205
+
To remove installed Kimiko files while preserving secrets:
206
+
207
+
```bash
208
+
make uninstall
209
+
```
210
+
211
+
---
212
+
213
+
## Legal and Usage Boundaries
214
+
215
+
Kimiko is intended only for:
216
+
217
+
* Systems you own
218
+
* Systems you are explicitly authorized to test
219
+
* Internal lab environments
220
+
* Capture-the-flag and training environments
221
+
* Professional red-team and penetration-testing engagements with written authorization
222
+
223
+
Kimiko is not intended for unauthorized access, credential theft, malware deployment, persistence, evasion, extortion, or activity against third-party systems without permission.
224
+
225
+
Review the full disclaimer before use:
226
+
227
+
```text
228
+
docs/legal/DISCLAIMER.md
229
+
```
230
+
231
+
---
232
+
233
+
## License
234
+
235
+
This project is licensed under the MIT License. See [`LICENSE`](LICENSE).
0 commit comments