Termcard

Your business card, in the terminal.

Created by Ahmet Erkan Paşahan

What is it?

Developers and designers spend their day in the terminal, so why not meet them there? Termcard turns a short description of who you are into a small interactive program that anyone can open with one command:

npx yourname

Your visitor sees a clean business card and a menu. With a few keystrokes they can write you an email, save you to their contacts, open your website and profiles, or switch the card to their own language. Nothing to install, nothing to sign up for.

Creating your own takes about two minutes and no code:

npm create termcard@latest

A short wizard asks for your details, shows a live preview, checks that your name is free on npm and publishes the card for you.

What your visitors can do

• Get in touch — opens a new email to you in their mail app
• Save contact — adds your vCard to their address book
• Visit your website and profiles — LinkedIn, GitHub, X, Behance, Dribbble and more
• Copy your email or phone number to the clipboard
• Switch language — the card follows their system language and can be changed from the menu

Features

• No code to fork or edit. Your card is a single, validated JSON file.
• Fourteen languages built in — the world's most spoken languages plus Turkish, German and French, including right-to-left Arabic and Urdu — and you can add your own.
• Eight seasonal color themes, from thaw to midwinter, designed to look calm on both dark and light terminals.
• Three layouts, optional icons and a short description; choose which details appear, in what order, or show only the menu.
• Ready for AI assistants. A built-in MCP server lets Claude and other assistants read cards and draft emails.
• Updates reach everyone. Cards depend on Termcard, so improvements arrive without republishing your card.
• Private and safe by design. Zero dependencies, no tracking, and every value in a card is validated and sanitized before it reaches anyone's terminal.

Ask your AI assistant

Termcard also speaks the Model Context Protocol. In Claude or any MCP client you can create your card just by chatting — "Create my terminal business card" — and look up anyone's card by name, save them as a contact or draft an email. Nothing is ever published or sent on your behalf.

/plugin install termcard --marketplace aepasahan/termcard

In Claude on the web, desktop or mobile, add the remote connector https://mcp.termcard.dev/mcp under Settings › Connectors. There's also a one-click Claude Desktop extension, and any MCP client works — see Termcard for AI assistants. Card owners can opt out with "mcp": false.

Customizing your card

Everything lives in card.config.json. Only your name is required:

{
  "$schema": "https://termcard.dev/schema.json",
  "name": "Jane Doe",
  "tagline": "@studio",
  "email": "[email protected]",
  "website": "https://jane.example.com",
  "links": ["https://www.linkedin.com/in/janedoe", "https://github.com/janedoe"],
  "language": { "available": ["en", "de"] },
  "theme": "frost",
  "icons": "symbols"
}

The configuration guide covers every option, and examples/full.json shows them all together. The $schema line gives you autocompletion and inline errors in your editor.

Command line

Termcard also ships a small tool for card owners. Visitors never see or need it.

Command	What it does
npx termcard preview	Opens your card locally, exactly as visitors will see it.
npx termcard validate	Checks your config and explains any mistakes.
npx termcard mcp	Runs the MCP server for AI assistants (see docs/mcp.md).
npx termcard build	Optional. Exports your card for use outside the terminal: a web page, vCards and plain-text versions, plus ready-made code so that curl yourdomain.com prints your card.

Requirements

Node.js 18.18 or newer on macOS, Linux or Windows. Visitors need nothing but npx, which comes with Node.js.

Project

This repository contains two packages:

Package
termcard	Renders and runs the cards. Every card depends on it.
create-termcard	The setup wizard behind npm create termcard.

Also here: plugin/ (the Claude plugin) and remote/ (the hosted MCP server). The website, termcard.dev, has its own repository.

Termcard follows Semantic Versioning: a card config that works with 1.0 keeps working in every 1.x release. See CHANGELOG.md.

Contributions are welcome — see CONTRIBUTING.md. Please report security issues privately as described in SECURITY.md. How Termcard handles personal data is described in PRIVACY.md.

---

Designed and built by Ahmet Erkan Paşahan · LinkedIn · GitHub · try it: npx aepasahan

Released under the MIT License.