Kanject.Cli
2.1.0
Prefix Reserved
See the version list below for details.
dotnet tool install --global Kanject.Cli --version 2.1.0
dotnet new tool-manifest
dotnet tool install --local Kanject.Cli --version 2.1.0
#tool dotnet:?package=Kanject.Cli&version=2.1.0
nuke :add-package Kanject.Cli --version 2.1.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 distribution release`: CLI-owned versions for desktop distributables (proposal 0058 P2).
A distributable can opt in with a `versioning` block (`"versioning": { "versionFile": "Directory.Build.props" }`); distributables sharing a version file release together. Its version is then never edited by hand: a change that needs a minor or a major declares it with `kanject packages intent add` (which now works in a repository with no package policy, and refuses `--package` there), and `kanject distribution release --env <stage>` writes the release commit. It reads which versions the stage's routed targets already hold (the stable `kanject-release.json` for `s3`, the repository's releases for `github-releases`), raises the committed version by the highest declared part, assembles the `changelog.d/` fragments under a dated `CHANGELOG.md` section (on by default; `"changelog": false` opts out), and commits on the current branch. It refuses a version that was cut but published nowhere (`KANCLI791`), a version file behind what shipped (`KANCLI785`), an unreadable channel (`KANCLI786`), a dirty checkout (`KANCLI788`) and an invalid block or a release with no notes (`KANCLI784`), and it never pushes. For a versioned distributable, `aws distribute` and `github distribute` now validate the block before building, need a clean checkout for a stable publish or `--candidate` and record `sourceCommit` and `productVersion` in the ledger, refuse to publish a version an S3 cell's stable feed already lists for that edition and RID (`KANCLI787`), keep the feed's `latest` at the highest stable version, and tag GitHub releases by the tag template (default `v{version}`) instead of the run stamp. Distributables without the block behave exactly as before.