kmc 0.4.1

kyle-mcmaster-dnx-card

This repository now produces two .NET CLI tools built on a shared library:

• kylemcmaster: Kyle McMaster's digital business card
• kmc: the full CLI with business card, agents, skills, and REPL support

Shared implementation lives in Card.Core.

Quick Start

dnx -y kylemcmaster
dnx -y kmc

Run locally from source:

dotnet run --project KyleMcMaster.Card
dotnet run --project Kmc.Card

Tool Overview

kylemcmaster

Business-card-only commands:

• default: full business card
• about: name, title, and location
• contact: links and contact info

kmc

Includes the same card commands plus the full agent and skill workflow:

• agent list
• agent run <name> --prompt "..."
• agent chat <name>
• skill list
• skill run <name> --input "..."

kmc keeps the original REPL configuration with the prompt kmc>, while the default no-argument route still shows the business card.

Markdown Agents

kmc loads declarative agents from the .agents/ directory in the current working directory. Each file uses YAML frontmatter plus a markdown body:

---
name: my-agent
description: What this agent does
model: claude-opus-4-6
skills:
  - greet
---

System prompt content goes here.

Built-in shared components include:

• echo agent
• greet skill
• LLM integration through Microsoft.Extensions.AI

LLM Configuration

The shared agent platform reads these environment variables:

• ANTHROPIC_API_KEY
• OPENAI_API_KEY
• LLM_PROVIDER
• LLM_MODEL

If no configured LLM is available, markdown agents fall back to returning their system prompt.

Project Structure

.agents/                  # Declarative markdown agents for kmc
Card.Core/                # Shared abstractions, services, agents, skills, rendering
Card.Core.Tests/          # Shared library tests
Kmc.Card/                 # Full CLI executable (kmc)
KyleMcMaster.Card/        # Business-card-only executable (kylemcmaster)
docs/plans/               # Implementation notes and plans

Development

Build everything:

dotnet build Card.slnx

Run tests:

dotnet test Card.slnx