# idank/explainshell

> Web tool that matches each command-line argument to the relevant man page text

Navigation: [Developer Tools](category/developer-tools.txt) · [Index](../llms.txt)

## Facts

- GitHub: https://github.com/idank/explainshell
- HTML: https://awesomeopensource.dev/project/idank-explainshell
- License: GPL-3.0
- Language: Python
- stars: 14340
- Activity score: 3.5/5 (Active)
- Last commit (any branch): 2026-08-26

## Description

explainshell parses a shell command into an abstract syntax tree and matches every option to the help text from the corresponding man page, returning an explanation for the whole line. Man pages are read and stored in SQLite, options are extracted from roff macros or with an LLM, and results are rendered by a Flask application. It can be run locally from the repository with a downloaded database of processed pages.

## Maintenance activity

- Recency: 54% (weight 40%) — last commit: 79 days ago
- Commit volume: 87% (weight 25%)
- Releases: 37% (weight 25%) — last release: 253 days ago
- Bug fixes: 100% (weight 10%)
- Commits: 14 / 90d, 484 / 365d

## Screenshots

- [Screenshot of explainshell showing the home page with a shell command input and examples](https://awesomeopensource.dev/uploads/1253/4fe7cc4e87e04a4d.png)
- [Screenshot of explainshell showing a command explanation with highlighted arguments in dark mode](https://awesomeopensource.dev/uploads/1253/b37822f8a1857b96.png)

## Similar projects

- [stablyai/orca](stablyai-orca.md): Run several coding agents in parallel, each in its own Git worktree · Activity score 5.0/5 (Thriving)
- [tauri-apps/tauri](tauri-apps-tauri.md): Build small desktop and mobile apps with a web frontend and a Rust core · Activity score 5.0/5 (Thriving)
- [microsoft/terminal](microsoft-terminal.md): Tabs, panes and GPU rendering for PowerShell, cmd, WSL and SSH on Windows · Activity score 5.0/5 (Thriving)
- [ant-design/ant-design](ant-design-ant-design.md): A UI Design Language. · Activity score 5.0/5 (Thriving)
- [microsoft/playwright](microsoft-playwright.md): End-to-end testing and browser automation across Chromium, Firefox and WebKit · Activity score 5.0/5 (Thriving)
- [nvm-sh/nvm](nvm-sh-nvm.md): POSIX shell script for installing and switching between Node.js versions · Activity score 5.0/5 (Thriving)
