English Français العربية

termcard

السجل الرسمي أخرى

Create terminal business cards (npx <name>) in a chat, or look up anyone's card.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع termcard؟

  • 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http termcard 'https://mcp.termcard.dev/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "termcard": {
            "type": "http",
            "url": "https://mcp.termcard.dev/mcp"
        }
    }
}
NPM package termcard
Claude Code 
claude mcp add termcard -- npx -y termcard@0.6.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "termcard": {
            "command": "npx",
            "args": [
                "-y",
                "termcard@0.6.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. termcard
  2. What is it?
  3. What your visitors can do
  4. Features
  5. Ask your AI assistant
  6. Customizing your card
  7. Command line
  8. Requirements
  9. Project

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, so AI assistants like Claude can look up any termcard card by name, save the person as a contact or draft an email to them — read-only, nothing is ever sent on your behalf.

claude mcp add termcard -- npx -y termcard mcp

For Claude Desktop there's a one-click 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:

{
  "name": "Jane Doe",
  "tagline": "@studio",
  "email": "jane@example.com",
  "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.

Command line

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

CommandWhat it does
npx termcard previewOpens your card locally, exactly as visitors will see it.
npx termcard validateChecks your config and explains any mistakes.
npx termcard mcpRuns the MCP server for AI assistants (see docs/mcp.md).
npx termcard buildOptional. 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
termcardRenders and runs the cards. Every card depends on it.
create-termcardThe setup wizard behind npm create termcard.

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.

الأسئلة الشائعة

ما هو termcard؟

Create terminal business cards (npx <name>) in a chat, or look up anyone's card.

كيف أثبّت termcard؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http termcard 'https://mcp.termcard.dev/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج termcard إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل termcard مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون termcard؟

ينشره aepasahan. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.