Metadata-Version: 2.4
Name: nodeskai
Version: 0.4.0
Summary: Skill-pack giup AI coding agent code ky luat hon, xay dung hoan toan tren dien thoai.
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# NoDeskAI

*[Đọc bằng tiếng Việt](README.vi.md)*

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Made in Vietnam](https://img.shields.io/badge/made%20in-%F0%9F%87%BB%F0%9F%87%B3%20Vietnam-red.svg)](#)
[![Built on a phone](https://img.shields.io/badge/built%20on-%F0%9F%93%B1%20a%20phone-brightgreen.svg)](#)

**Your AI coding agent keeps guessing, over-engineering, and editing code
outside the scope you asked for. NoDeskAI fixes that — in one command.**

NoDeskAI is a skill-pack for AI coding agents (Claude Code, Cursor, Codex
CLI, Windsurf...): install it once and your agent stops silently guessing
at ambiguous requests, stops bloating simple tasks into over-engineered
solutions, and stops touching code outside what you asked for. It ships
with `audit` — a built-in scanner that checks the skill/rule files you're
about to trust for bloat, duplicate rules, and prompt-injection patterns.

> 🇻🇳 **Made in Vietnam.** Every line of this project — writing, testing,
> committing, and pushing to GitHub — was done entirely on an Android
> phone through Termux. No PC, no laptop, no iPad.

## Install

```bash
pip install nodeskai
```

## Usage

```bash
cd your-project
nodeskai init
```

This writes the full discipline ruleset into **all 4 agent-config files**
(`CLAUDE.md`, `.cursorrules`, `AGENTS.md`, `.windsurfrules`) — creating
whichever ones don't exist yet, and appending to any that already have
content of your own (your existing content is kept, NoDeskAI's block is
added below it). It also creates `NODESKAI.md` as the source of truth.
Every file gets a metadata line (flags + version) at the top so `sync`
knows how to update it later.

### Optional modes

```bash
nodeskai init --strict            # extra guardrails for high-risk decisions
nodeskai init --fast              # relaxed rules for obviously trivial tasks
nodeskai init --product-context   # adds a product/team-context skill (missing from the original CLAUDE.md)
```

`--strict` and `--fast` can't be combined (they're opposite modes).

### Update when a new skill version is available

```bash
nodeskai sync
```

Updates **every file NoDeskAI manages** (NODESKAI.md + installed
agent-configs) to match the currently installed NoDeskAI version, keeping
each file's own flags from `init` and preserving any hand-written content
that came before the NoDeskAI block. Files with no NoDeskAI metadata
(hand-written, never run through `init`) are reported as `[SKIP]` — they
don't break the command.

### Check installed skill/agent-config files

```bash
nodeskai audit
```

Scans every skill/agent-config file in the project for:
- **Bloat** — files over 150 lines, where important rules risk getting
  buried.
- **Duplicate rules** — a sign of rules being added over time without ever
  being cleaned up.
- **Suspicious patterns** — prompt-injection attempts, destructive
  commands, data-exfiltration signs.

## Current status

v0.4.0 — `init` writes the full skill into all 4 agent-config files at
once, `audit` is fully functional (bloat / duplicates / suspicious
patterns), `sync` updates every managed file when a new skill version is
available, keeping each file's own flags.

## Support the project

If NoDeskAI is useful to you, you can support it through GitHub Sponsors
(link coming soon) or Ko-fi.

## License

MIT
