intent-system / intent-cli

intent-cli is deterministic support tooling for running an intent-driven development workflow on top of GitHub. It helps you organize intents, prepare and publish Child Issue Contracts, drive implementation and review loops, and recover when a loop looks wrong — all through explicit, inspectable commands.

intent-cli never launches Claude, Codex, or any other AI provider. It emits guidance, validates contracts, and performs bounded GitHub/metadata transitions. The AI agent (you, or your coding assistant) stays in the driver's seat and asks intent-cli what to do next.

• Package id / command: intent-cli
• License: Apache-2.0
• Repository: https://github.com/J-Tech-Japan/intent-system

ドキュメント / Documentation: 日本語 | English

はじめての方へ: インストール後、intent-cli --version で動作確認し、 Claude・Codex・Copilot などの AI エージェントのチャットで intent-cli に聞いて... と伝えるだけで始められます。 詳しくは日本語ドキュメントをご覧ください。

---

Quickstart

1. Install

You need a .NET 10 SDK (dotnet --version should report 10.x).

dotnet tool install -g JTechJapan.IntentSystem.Cli

If intent-cli is not found after install, add ~/.dotnet/tools (macOS/Linux) or %USERPROFILE%\.dotnet\tools (Windows) to your PATH.

No .NET SDK? See Install without a .NET SDK for self-contained binaries. Need the preview channel? See the developer reference.

2. Verify

intent-cli --version

3. Ask an AI agent

Open Claude, Codex, Copilot, or another coding assistant with access to your repository and paste one of these prompts:

Start or continue a project:

I want to work on <owner>/<repo> with intent-cli. Ask intent-cli what phase I'm in and what I should decide next.

Start an implementation loop:

Set up a child implementation loop for <owner>/<repo>. Ask intent-cli for the next step.

The agent runs intent-cli commands internally and brings back questions or results. You focus on intent, priorities, and approval decisions.

---

Documentation

• English: docs/en/ — install, project start, intent organization, packet/issue creation, implementation & review loop setup, recovery.
• 日本語: docs/ja/ — 同上のドキュメント日本語版。
• Command reference: docs/en/08-command-reference.md — agent-facing and power-user command surfaces.
• Developer reference: docs/en/09-developer-reference.md — packaged invocation smoke test, preview channel, version flow.

---

Community

Join the J-Tech JAPAN OSS Discord for community discussion, questions, and lightweight support. Discord is for general chat; for reproducible bugs or actionable feature requests, please open a GitHub issue instead. Security-sensitive reports go to SECURITY.md, not Discord.

---

License

This project is licensed under the Apache License, Version 2.0 — see the LICENSE file for the full text and NOTICE for attribution. The published intent-cli NuGet package declares Apache-2.0 via SPDX license metadata.

Release artifacts (the NuGet package and self-contained binaries) and OSS preview CI artifacts carry no expiration or private-use gating.