NOTTH

English · Tiếng Việt · 简体中文 · Español

Reusable agent workflows for software development: Requirements → Design → Code → Test → Review.

Give an idea, existing docs or a change request to your AI coding tool. NOTTH helps it inspect the project, clarify open decisions, implement accepted scope and maintain relevant specs/docs. Use only the roles and skills the task needs.

Works with any project through Core workflows. Optional stack support: Spring Boot, React/Next.js, React Native, Python, Astro and Kubernetes. Stack selection does not choose infrastructure or architecture.

Registry commands require a published package containing the selected host support. If npm returns E404, use the reviewed source/offline path.

Quick start

Requires Node.js 22+ and your AI coding tool. Run in your project root:

npx --yes @manhd_d/notth init --host codex

Set --host to codex, claude-code, cursor, copilot, gemini-cli, kiro, opencode or windsurf. Choose the one tool you use; NOTTH installs only its required bridge. Shared setup and migration. In your first AI session, invoke harness-start if the host exposes it, or send:

Read .agents/skills/harness-start/SKILL.md and follow it for this project. My task: [task].

The agent inspects the project, asks only missing questions, saves context and continues your task. Review its changes and test results. In later sessions, describe the next task directly or ask to resume saved work. The agent maintains task context and checks linked sources as part of the workflow; session continuity and limits. Native continuity hooks for the selected host: enable once with init --host codex --session-hooks (or update --host codex --session-hooks). The host-specific bridge observes events and injects capture/recovery instructions where supported; activation states and host limits. Installation alone does not prove activation or saved memory; the agent checks current-session receipts and actual saved files. No terminal interview, model configuration or manual skill sequence is required. Kiro exposes /harness-start; native discovery varies by client. Host guides. npx does not create a global command; use npx --yes @manhd_d/notth check to check integrity.

Daily use

After the first-session entry point is loaded, describe the outcome:

• “Fix this bug and show the regression check.”
• “Add filtered export; preserve current permissions and prepare a PR.”
• “Continue the saved task and tell me what remains.”

The agent chooses the necessary depth, reuses confirmed decisions and reports completed work, blockers and the next action. You do not need to select roles or gates.

Short prompts & troubleshooting · pip/offline · Settings & backup. Project configuration lives in .notth/; upgrade an existing installation. UI design, previews & optional design skills. Coding & technical documentation. Python installation still requires Node.js 22+; it does not call npm. Registry availability must be verified.

Where it runs

| AI tool | Environment | Install the tool | NOTTH setup | | --- | --- | --- | --- | | Codex | CLI, IDE or connected cloud workspace | Install | Guide | | Claude Code | Project terminal | Install | Guide | | Cursor | IDE Agent | Install | Guide | | GitHub Copilot | IDE Agent or CLI | Install | Guide | | Gemini CLI | Project terminal | Install | Guide | | OpenCode | Terminal / IDE | Install | Guide | | Windsurf | IDE Cascade | Install | Guide | | Kiro | IDE, CLI or connected Web workspace | Install | Guide |

Local/cloud execution and external inputs depend on the host's actual access. MCP/connector/API connections can supply docs, designs, tickets and evidence under project source policies.

Daily use & recovery · Getting started · Docs & examples · Input/output · Agent configuration · Continuous development

Contributing · NOTTH maintenance · MIT

Persistent input documents: originals, Markdown and recovery.