Skip to content

TimeWarpEngineering/ardalis-card-dnx

 
 

Repository files navigation

ardalis-card-dnx

NuGet NuGet Downloads

A .NET global tool that displays a personal business card in your terminal. 💠

Overview

A CLI tool built for the .NET ecosystem using the new dnx command introduced in .NET 10! Run it instantly to access Steve "Ardalis" Smith's resources and information—no installation required!

Quick Start with dnx

The easiest way to run this tool is with the new dnx command (similar to npx in Node.js):

dnx ardalis

That's it! The first time you run it, you'll be prompted to confirm the download. After that, it runs instantly without confirmation.

Available Commands

View help and available commands:

dnx ardalis

Display the business card:

dnx ardalis card

Open Ardalis's blog:

dnx ardalis blog

Open Ardalis's Dometrain Author profile:

dnx ardalis dometrain

Open Ardalis's YouTube channel:

dnx ardalis youtube

Open Ardalis's Pluralsight profile:

dnx ardalis pluralsight

Open Ardalis's newsletter subscription page:

dnx ardalis subscribe

Display a random quote:

dnx ardalis quote

Display popular GitHub repositories:

dnx ardalis repos

Display popular NuGet packages:

dnx ardalis packages
# or show all packages including sub-packages
dnx ardalis packages --all

Display published books:

dnx ardalis books

Display recent activity across platforms:

dnx ardalis recent
# or use verbose mode to see detailed progress
dnx ardalis recent --verbose

Display a random coding tip:

dnx ardalis tips

Display available courses:

dnx ardalis courses

Open NimblePros website:

dnx ardalis nimblepros

Check the version:

dnx ardalis --version

Interactive Mode

Run in interactive mode to execute multiple commands without re-running the tool:

dnx ardalis -i

In interactive mode, simply type commands:

> card
(displays card)

> quote
"New is glue." - Ardalis

> repos
(displays popular GitHub repositories with stars)

> books
(displays published books)

> blog
(opens blog)

> dometrain
(opens Dometrain Author profile)

> exit

Exit by typing exit, quit, or pressing Enter on an empty line.

Recent Activity Command

The recent command displays your latest activity from multiple platforms:

dnx ardalis recent

Use --verbose to see detailed progress from each source:

dnx ardalis recent --verbose

The verbose mode shows:

  • ✅ Number of results found from each source
  • ⚠️ Sources with no results
  • ❌ Any errors encountered while fetching data

Activity is displayed with relative timestamps like "5 min ago" or "2 hours ago" for recent items, and short dates for older items.

Permanent Installation

To install globally and run as just ardalis (without dnx):

dotnet tool install -g ardalis

Then run from anywhere:

ardalis            # Show help
ardalis card       # Display business card
ardalis blog       # Open blog
ardalis dometrain  # Open Dometrain Author profile
ardalis youtube    # Open YouTube channel
ardalis pluralsight # Open Pluralsight profile
ardalis quote      # Display random quote
ardalis repos      # Display popular GitHub repositories
ardalis packages   # Display popular NuGet packages
ardalis books      # Display published books
ardalis recent     # Display recent activity across platforms
ardalis tips       # Display a random coding tip
ardalis courses    # Display available courses
ardalis nimblepros # Open NimblePros website
ardalis --version  # Check version

Managing the Installation

Update to the latest version:

dotnet tool update -g ardalis

Uninstall:

dotnet tool uninstall -g ardalis

Features

  • One-command execution with the new dnx command—no installation needed!
  • 🎨 Beautiful terminal UI with Spectre.Console
  • 💼 Quick access to professional links
  • 🌐 Cross-platform (Windows, macOS, Linux)
  • 🚀 Built with .NET 10.0

dnx vs. Global Installation

Key Differences:

Method Command Installation Use Case
dnx dnx ardalis None (downloads on first run) Try it once, occasional use
Global Tool ardalis Permanent (dotnet tool install -g) Frequent use, always available

The dnx command is .NET's answer to Node.js's npx, introduced in .NET 10. It allows you to run .NET tools on-demand without explicitly installing them. Perfect for trying out tools or running one-off commands!

Learn more: Running one-off .NET tools with dnx

Building from Source

dotnet build
dotnet pack
dotnet tool install -g --add-source ./bin/Debug ardalis

About

Created by Steve "Ardalis" Smith

Specializing in Clean Architecture, Domain-Driven Design, and .NET development.

Contributing

For maintainers: See CONTRIBUTING.md for instructions on publishing new versions.

About

A dnx runnable personal card CLI.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 100.0%