Kanject.Cli
1.2.0
Prefix Reserved
See the version list below for details.
dotnet tool install --global Kanject.Cli --version 1.2.0
dotnet new tool-manifest
dotnet tool install --local Kanject.Cli --version 1.2.0
#tool dotnet:?package=Kanject.Cli&version=1.2.0
nuke :add-package Kanject.Cli --version 1.2.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. 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 —
dotnet new+kanject initputs the manifest, NuGet config, and dotnet-tool pinning in place in one step. - 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 preview environments, VPC & custom-domain wiring, multi-function services, and AWS-native pipeline scaffolding.
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 | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. 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. |
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` checks entries against what the deploy provider supports, and `kanject init` writes the provider-neutral layout (proposal 0054).
For AWS projects nothing reports differently except one new check. AWS's own rules (Lambda and ECS runtime and packaging, one ECS entry per service, the `[LambdaFunction]` scan) moved from the CLI host into the AWS plugin and report as before.
- An entry's `architecture` other than `arm64` or `x86_64` is now `KANCLI768` in `doctor`, instead of failing later in the build.
- `kanject init` writes manifest schema 3 and stage schema 2 for multi-entry services: the same files `kanject migrate --schema-v3` produces. Single-Lambda (v1) projects are unchanged.
- `kanject test` and the IDE bootstrap take `AWS_PROFILE` / `AWS_REGION` from the provider rather than setting them in the host; the values are the same.
- New codes for providers that support less than AWS: `KANCLI762` (a deploy-target kind the provider doesn't deploy), `KANCLI765` (a weighted rollout it can't split), `KANCLI770` (`param:` without a parameter store).
- `kanject migrate --schema-v3` moves a project to the provider-neutral layout (proposal 0054).
Nothing about how a service deploys changes; every command reads the new files exactly as the old ones, and the old files keep working for all of 1.x.
- The manifest's `aws` block becomes `deployment` (`provider`, `defaultStage`, `stages`, and `aws: { changeFeeds }`), and `deployTarget` becomes `function` / `container` / `static-site`. `lambda` and `ecs-fargate` stay accepted.
- Stage files keep what every cloud has at the top level (`region`, `env`, `function`, static-site and API domain names, `http`, `rollout`, `targets[]`) and move what only AWS has under `aws`: `profile`, `stack`, `artifactBucket`, `ecrRepository`, `parameterStore`, `network`, `container` (was `ecs`), certificates and hosted zones, `changeFeeds`.
- Every converted file is read back before anything is written, and must give exactly what the original gives. `--dry-run` previews. Commands that write the manifest or a stage file keep it at its version.
- `kanject doctor` mentions the upgrade as info (`KANCLI760`). New codes for the new layout: `KANCLI763` (stage and manifest name different providers), `KANCLI764` (a required AWS setting is missing, all named at once), `KANCLI767` / `KANCLI769` (a provider block this CLI can't read, or one for another provider) and `KANCLI771` (a schema-1 stage file with settings in its `aws` block).