Termcards
Context-aware cheatsheets that appear when you need them.
What it does
Termcards automatically detects your terminal environment and displays relevant keyboard shortcuts and code examples. No searching, no memorizing commands - just the right information at the right time.
$ termcards
Detected: tmux → micro → python
[Shows Python patterns, Micro shortcuts, and tmux commands in adaptive layout]
Installation
uv tool install termcards
Usage
# Auto-detect context and show relevant sheets
termcards
# Show specific sheet
termcards --sheet python
# Choose display mode (reference shortcuts or code examples)
termcards --mode code
# Live mode - continuously track active pane
termcards --live
# Analyze specific tmux pane
termcards --pane %26
# Focus on specific context when multiple detected
termcards --focus micro
Features
- Smart Detection: Recognizes tmux, editors (Micro, Vim), languages (Python), and deployment tools (Fly.io)
- Multiple Modes: Reference mode for shortcuts/commands, Code mode for examples
- Live Tracking: Continuously updates display as you switch panes (--live)
- Adaptive Layouts: Automatically adjusts to terminal width
- Rich Formatting: Syntax highlighting and beautiful terminal UI
- Zero Config: Works immediately without setup
How it works
Termcards uses a detection pipeline to identify nested contexts. When you're editing Python in Micro inside tmux, it shows all three relevant cheatsheets, prioritizing the innermost context.
Supported Contexts
- tmux - Terminal multiplexer commands
- Shell - Shell-specific commands (bash, zsh, fish)
- Micro - Modern terminal editor shortcuts
- Python - Code patterns and idioms (code mode in development)
- Fly.io - Deployment commands
Adding Custom Sheets
Create YAML reference sheets or Python code examples:
# src/termcards/sheets/reference/tool.yaml
name: tool
sections:
- name: essential
items:
- key: "Ctrl-X"
desc: "Do something"
# src/termcards/sheets/code/language.py
# @section: patterns
# @title: Language Patterns
def example():
pass
Development
# Clone and install
git clone https://github.com/angelsen/termcards
cd termcards
uv run termcards
# Validate sheets
uv run termcards --check
# Run with debug info
uv run termcards --debug
License
MIT
Metadata
Release files for termcards 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| termcards-0.1.1.tar.gz | 24.6 kB | Without provenance | Details for termcards-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| termcards-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for termcards-0.1.1-py3-none-any.whl |
Total release size: 60.7 kB
Release files / termcards-0.1.1.tar.gz
| Download URL | termcards-0.1.1.tar.gz |
|---|---|
| Size | 24.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8fdae2413d5fc6ee04b94b7480c8415b234627a3f6c106da624599201a1e5db4
|
|
BLAKE2b-256 checksum How to use checksums |
6446a049bbcbded0eb28f16dca7e25111c274e13c86dbcc37e5d048040e1f234
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.12
|
Release files / termcards-0.1.1-py3-none-any.whl
| Download URL | termcards-0.1.1-py3-none-any.whl |
|---|---|
| Size | 36.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e1267a2604da8229bc3e799ace044e3817e9965ed255fa8a81c9cba5364735a3
|
|
BLAKE2b-256 checksum How to use checksums |
c8c2f2ad7572510773adf43cbd271c976e81b7c43c4aaa71759b941bfd4c6676
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.12
|
Security for termcards 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.