Kanject.Cli
2.4.0
Prefix Reserved
See the version list below for details.
dotnet tool install --global Kanject.Cli --version 2.4.0
dotnet new tool-manifest
dotnet tool install --local Kanject.Cli --version 2.4.0
#tool dotnet:?package=Kanject.Cli&version=2.4.0
nuke :add-package Kanject.Cli --version 2.4.0
Kanject.Cli
A single .NET global tool that drives C# AWS services from dotnet new to
kanject aws deploy --env prod — wrapping the existing dotnet/AWS toolchain so
your inner loop stays vanilla and the Lambda, ECS Fargate, static-site, and
coupled full-stack deploy plumbing disappears behind one committed manifest.
Install
dotnet tool install --global Kanject.Cli
Requires the .NET 10 SDK or later (the .NET 11 SDK installs its .NET 11 build). The aws, msbuild, and github providers ship
in the box — no extra installs.
Choose a workflow
- Deploy applications: Lambda, ECS Fargate, or a coupled SPA/backend. Choose independent service roots, a shared multi-Lambda stack, or a coordinated frontend/backend pair.
- Publish libraries:
kanject packages init, thenkanject packages planandkanject packages verifyfrom the package repository root. - Distribute desktop apps: initialize the product manifest, register with
kanject add distributable, and configure delivery destinations.
Start at Getting started for workflow selection. Service commands run from the directory containing that service's manifest, which can differ from the repository or solution root. The current static-site shape requires a coupled backend.
Discover commands with kanject --help and kanject aws --help.
What it does
- Bootstrap —
kanject newscaffolds a project from a bundled template and initializes it;kanject initadds the manifest, stage files and lock file to an existing project. - Deploy —
kanject aws deploy --env <stage>resolves cross-repo dependencies and env, builds the provider artifacts, and ships the manifest's target (Lambda, ECS Fargate, static site, or a coupled backend + site), recording every release in an S3 deployment ledger. - Rollback —
kanject aws rollback --env prodshows the last 10 deployments with dates, statuses, targets, and commit summaries; pick one and Kanject does the target-native promotion with the prior artifact still immutable in S3/ECR. - And more — cross-repo dependency sync, a local test runner, env/param/secret
management, static-site previews and ephemeral backend previews
(
kanject aws deploy --preview <NAME>), DynamoDB change feeds, a managed streaming Function URL and CloudFront edge, VPC & custom-domain wiring, multi-function services, AWS-native pipeline scaffolding, NuGet package publishing, desktop distribution, and sign-in for paid Kanject packages (kanject login,kanject add package).
It invokes — never replaces — dotnet new, dotnet build, and dotnet lambda, and drives AWS services through their SDK APIs (including
CloudFormation change sets). The dotnet-native experience stays; kanject only
owns the AWS plumbing that doesn't have a great answer in the box.
Learn more
- Getting started: kanject.com/docs/getting-started
- Website: kanject.com/cli
- In-tool help:
kanject --help,kanject aws --help
License
Commercial — governed by the Kanject Code Libraries License Agreement (KCLLA);
see the bundled LICENSE.md. © Kanject Business Solutions.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. net11.0 is compatible. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.5.0 | 103 | 11/16/2026 |
| 2.4.0 | 93 | 11/16/2026 |
| 2.3.0 | 113 | 11/15/2026 |
| 2.2.0 | 128 | 11/14/2026 |
| 2.1.0 | 96 | 11/13/2026 |
| 2.0.2 | 102 | 11/13/2026 |
| 2.0.1 | 94 | 11/13/2026 |
| 2.0.0 | 100 | 11/12/2026 |
| 1.5.1 | 123 | 11/11/2026 |
| 1.5.0 | 121 | 11/10/2026 |
| 1.4.0 | 106 | 11/4/2026 |
| 1.3.0 | 119 | 11/2/2026 |
| 1.2.0 | 157 | 11/1/2026 |
| 1.1.0 | 115 | 11/1/2026 |
| 1.0.79 | 111 | 10/30/2026 |
| 1.0.78 | 101 | 10/30/2026 |
| 1.0.77 | 108 | 10/29/2026 |
| 1.0.76 | 102 | 10/29/2026 |
| 1.0.75 | 100 | 10/29/2026 |
| 1.0.74 | 101 | 10/28/2026 |
- `kanject doctor` validates `scripts.json` (proposal 0060 P2).
A broken scripts file showed only when someone ran `kanject run`. Doctor now reads the file `kanject run` would read from the folder it runs in, with the same strict reader, and reports one row: the file and its script count, or the `KANCLI1000` error a run would stop on (doctor then exits 1). It needs no manifest, reads one local file and starts nothing. Whether a script can start on this machine is still `kanject run <NAME> --explain`'s question.
- Bare `kanject` points at `kanject run` when the directory declares scripts (proposal 0060 P2).
The landing now adds a Project scripts lane, `List the <n> scripts this repository declares kanject run`, in a directory whose metadata folder holds `scripts.json`. A library repository with only that file gets the lane instead of "No workflow configured". Like the rest of the landing it reads the exact current directory only. An invalid file shows its `KANCLI1000` error and the landing exits 1, without hiding the other workflows.
- An editor schema for `scripts.json` (proposal 0060 P2).
The scripts file `kanject run` reads is strict, and until now an editor could not say what it accepts. The CLI now embeds a JSON Schema for it.
- `kanject init --refresh-schema` writes it as `scripts.schema.json` beside a `scripts.json` that has none, and rewrites a copy an older CLI wrote. Point the file at it with `"$schema": "./scripts.schema.json"`; an editor then completes the keys and flags an unknown key, a blank or multi-line value, a bad script name or an unknown platform as you type.
- It works in a repository with no manifest. `--refresh-schema` refused a folder without `manifest.json` (`KANCLI002`); a `scripts.json` in the metadata folder is now enough, which is all a library repository has. It still never creates an absent manifest or stage copy.
- `kanject doctor` reports a stale copy under the existing `KANCLI776` warning, which now covers every editor schema copy in the metadata folder.
- The reader stays the authority: a `run[0]` path that leaves the repository folder and a key that appears twice are refused by `kanject run` but not flagged by the schema.