# karan/joe

:running: A .gitignore magician in your command line

Repository: https://github.com/karan/joe
Canonical: https://ross.abutalabs.com/products/joe
Homepage: http://karan.github.io/joe/
Language: Go
License: MIT
License Family: permissive
Topics: gitignore, linux, mercurial, magician, git
Last push: 2024-05-30T10:08:05+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4252, "days_push": 825, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2865, forks 205 (observed 2026-08-28T04:07:26.588588+00:00)

## What it is
joe is a command-line tool that generates .gitignore files from GitHub's collection of gitignore templates. It supports multiple languages and IDEs per invocation, can append to existing or global ignore files, and also supports Mercurial's .hgignore.

## Use cases
- generate a .gitignore file for a java project from the command line
- create a combined gitignore for multiple languages like java, node, and osx
- append IDE and OS entries like OSX and SublimeText to a global gitignore
- list all available gitignore templates
- update local gitignore template data
- generate .hgignore files for mercurial repositories

## When to choose
- you want to quickly scaffold a .gitignore for a new project without browsing GitHub
- you need ignore files for multiple languages or IDEs in one command
- you want a simple single-binary tool with no dependencies

## When to avoid
- you need gitignore templates beyond what GitHub's gitignore repository provides
- you prefer editor plugins or GUI tools for managing ignore files
- you need actively developed features - the project is in maintenance mode

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: cli, developer-tools, version-control, file-system
- domain: developer-tools, version-control
- platform: windows, cli
- tags: gitignore, git, mercurial, go, command-line, macos, linux

## Member repositories
- karan/joe (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:26.588588+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:36:14.019099+00:00, confidence not recorded.
  - readme: https://github.com/karan/joe (fetched 2026-08-28T04:07:26.588588+00:00, sha 1a5c61b32645)
  - homepage: http://karan.github.io/joe/ (fetched 2026-08-29T09:51:50.075286+00:00, sha 02870a04f2c8)
- Data as of 2026-08-30T08:39:29.467469+00:00.