This repo contains the .NET Core command-line (CLI) tools, used for building .NET Core apps and libraries through your development flow (compiling, NuGet package management, running, testing, ...).
C# Shell PowerShell Groovy Batchfile Visual Basic
Clone or download
dsplaisted Merge pull request #9654 from dseefeld/conditionallyInstall112
Conditionally install the 1.1.2 runtime when building from source
Latest commit 5632ca0 Jul 12, 2018
Permalink
Failed to load latest commit information.
Documentation Merge branch 'master' into merges/release/2.1.4xx-to-master Jun 6, 2018
TestAssets Merge branch 'master' into merges/release/2.1.4xx-to-master Jun 6, 2018
build Update version to: 3.1.100-alpha1 - CLI (#9639) Jul 10, 2018
build_projects bytestoWrite -> bytesToWrite Jun 28, 2018
packaging/windows Corrected spelling; reduced the 'MSBuildExtensions' fileset. Jul 10, 2018
resources Remove ImportAfter target for NuGet Oct 25, 2017
scripts Update version to: 3.1.100-alpha1 - CLI (#9639) Jul 10, 2018
src Merge pull request #9571 from github-john-doe/typo Jun 29, 2018
test bytestoWrite -> bytesToWrite Jun 28, 2018
tools Merge branch 'dev/release/2.0' into merge_dev_release_20 Dec 8, 2017
.editorconfig Checkin corefx editorconfig Sep 18, 2017
.gitattributes Treat xlf as text Dec 8, 2017
.gitignore Merge branch 'master' into merges/release/15.5-to-master-20171204-080035 Dec 4, 2017
CONTRIBUTING.md merge master Mar 20, 2017
Directory.Build.props Merge branch 'master' into merge_master Jun 8, 2018
ISSUE_TEMPLATE issue template, the --info is the new --version Mar 31, 2016
LICENSE Initial commit Oct 2, 2015
Microsoft.DotNet.Cli.sln Merge branch 'master' into merge_master_into_repo_refactoring May 22, 2018
PULL_REQUEST_TEMPLATE add PR template May 3, 2016
README.md Merge pull request #9597 from dotnet/merges/release/2.2.1xx-to-master Jun 29, 2018
THIRD-PARTY-NOTICES Add license text to LZMA SDK license notice Feb 26, 2017
build.cmd The modification to build.cmd did not have the desired effect. Nov 29, 2017
build.proj Merge branch 'master' into merge_master_into_repo_refactoring May 22, 2018
build.sh Add Dockerfile for RHEL 6 builds Sep 26, 2017
dir.props Adding consistent "Project" headers to inported props and target files. Sep 27, 2017
dir.tasks Bump MSBuild Version to 15.1.0-preview-000503-01 (#5199) Jan 5, 2017
netci.groovy Update version to: 3.1.100-alpha1 - CLI (#9639) Jul 10, 2018
run-build.ps1 Conditionally install the 1.1.2 runtime when building from source sin… Jul 12, 2018
run-build.sh Conditionally install the 1.1.2 runtime when building from source sin… Jul 12, 2018
testAsset.props Additional changes to make repo-refactoring compile/test successfully. May 25, 2018

README.md

.NET Command Line Interface

Join the chat at https://gitter.im/dotnet/cli

This repo contains the source code for cross-platform .NET Core command line toolchain. It contains the implementation of each command and the documentation.

Looking for the .NET Core SDK tooling?

If you are looking for the latest nightly of the .NET Core SDK, see https://github.com/dotnet/core-sdk.

Found an issue?

You can consult the Documents Index to find out the current issues and to see the workarounds.

If you don't find your issue, please file one! However, given that this is a very high-frequency repo, we've setup some basic guidelines to help you. Please consult those first.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.

Build Status

Windows x64

Basic usage

When you have the .NET Command Line Interface installed on your OS of choice, you can try it out using some of the samples on the dotnet/core repo. You can download the sample in a directory, and then you can kick the tires of the CLI.

First, you will need to restore the packages:

dotnet restore

This will restore all of the packages that are specified in the project.json file of the given sample.

Then you can either run from source or compile the sample. Running from source is straightforward:

dotnet run

Compiling to IL is done using:

dotnet build

This will drop an IL assembly in ./bin/[configuration]/[framework]/[binary name] that you can run using dotnet bin/[configuration]/[framework]/[binaryname.dll].

For more details, refer to the documentation.

Building from source

If you are building from source, take note that the build depends on NuGet packages hosted on MyGet, so if it is down, the build may fail. If that happens, you can always see the MyGet status page for more info.

Read over the contributing guidelines and developer documentation for prerequisites for building from source.

Questions & Comments

For all feedback, use the Issues on this repository.

License

By downloading the .zip you are agreeing to the terms in the project EULA.