standup-term 📋

Multi-repo Git activity aggregator, commit categorizer, and daily standup digest generator for terminal, Slack, Markdown, and Jira.

Never scramble before daily standup trying to remember what you worked on yesterday or last week across 5 different local repositories. standup-term recursively discovers all Git repos, groups commits by project, classifies Conventional Commits (feat, fix, docs, refactor), and generates formatted recaps.

✨ Features

• 🔍 Multi-Repo Auto-Discovery: Recursively scans your workspace (~/coding, ~/projects) for all Git repositories up to a configurable search depth.
• 🏷️ Conventional Commit Classification: Auto-tags commits with badges ([feat], [fix], [docs], [refactor], [perf], [chore]).
• ⏱️ Flexible Timeframes: --since "yesterday", --since "today", --since "monday", --since "7 days ago", or --days 3.
• 📋 Multi-Format Export:
  • Terminal Tree: Beautiful ANSI cards with branches, commit hashes, relative times, and color badges.
  • Markdown (--markdown): Clean Markdown for GitHub PR descriptions, Jira tickets, and Notion daily logs.
  • Slack (--slack): Bullet list syntax ready to copy-paste directly into Slack standup channels.
  • JSON (--json): Structured output for integration into custom developer dashboards.
• 👤 Smart Author Filtering: Automatically matches your Git author name/email, or specify --author "all" / --author "Jane".

🚀 Installation

Global CLI Tool

npm install -g standup-term
# or run directly with npx
npx standup-term
# or using short alias
npx standupx

In Your Project (Library)

npm install standup-term

🛠️ CLI Usage & Examples

1. Daily Standup (Yesterday to Now)

standupx

2. Scan Specific Workspace Folder

standupx ~/coding

3. Copy-Paste Ready for Slack

standupx --slack

4. Markdown for Notion / GitHub PR Notes

standupx --markdown --days 3

5. Filter by Author or Include Merges

standupx --author "[email protected]" --since "monday" --merges

📖 Programmatic API (TypeScript & JavaScript)

import { standup, generateStandupReport } from "standup-term";

// 1. Generate Formatted Output String
console.log(
  standup({
    paths: ["/home/user/coding"],
    since: "yesterday",
    format: "terminal", // "terminal" | "markdown" | "slack" | "json"
  })
);

// 2. Structured Report Object
const report = generateStandupReport({
  paths: ["/home/user/coding"],
  days: 7,
});

console.log("Total Commits:", report.totalCommits);
for (const repo of report.repos) {
  console.log(`${repo.name} (${repo.branch}): ${repo.commits.length} commits`);
}

⚙️ CLI Options Reference

| Option | Shorthand | Default | Description | | :--- | :--- | :--- | :--- | | --since <time> | -s | "yesterday" | Timeframe (e.g. yesterday, today, monday, 7 days ago) | | --days <number> | -d | | Past number of days to include | | --author <name> | -a | Current Git user | Filter commits by author name/email or all | | --markdown | -m | false | Output formatted Markdown | | --slack | | false | Output formatted Slack bullet list | | --json | -j | false | Output structured JSON | | --depth <depth> | | 3 | Repository scan depth | | --merges | | false | Include merge commits |

🧪 Development & Testing

git clone https://github.com/authoritydmc/standup-term.git
cd standup-term
npm install
npm test
npm run build

🚀 Automated Release & Versioning

1-Click from GitHub Actions

Go to Actions -> Automated Version & Release -> Select patch, minor, or major -> Click Run workflow.

From Terminal

npm run release:patch
npm run release:minor
npm run release:major

📄 License

MIT © 2026 authoritydmc