Show HN: Git-temp – scratchpad folder for AI agents; doesn't clutter Git status

sebmellen1 pts0 comments

GitHub - sebmellen/git-temp · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

sebmellen

git-temp

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>4 Commits<br>4 Commits

bin

bin

test

test

FUTURE_GAP_ANALYSIS.md

FUTURE_GAP_ANALYSIS.md

LICENSE

LICENSE

README.md

README.md

package.json

package.json

View all files

Repository files navigation

git-temp

Purpose: create a local AI scratchpad inside a Git repo without committing it.

git-temp makes a temp/ folder, adds it to .git/info/exclude, and keeps it visible to editors and AI tools. That means no noisy git status, no accidental commits, and no .gitignore rule that hides files from indexing or @ tagging.

Use

npx git-temp # creates temp/<br>npx git-temp notes # creates notes/<br>npx git-temp status # shows hidden scratchpad contents<br>npx git-temp clean -f # empties and recreates temp/<br>npx git-temp integrate # updates existing agent instruction files

What it creates

temp/scripts/ for one-off scripts

temp/dumps/ for JSON, CSV, logs, and payloads

temp/drafts/ for notes and draft specs

temp/scratch/ for experiments

temp/README.md explaining the folder to humans and AI agents

Intention list

Keep scratch work searchable and taggable by AI/editor tooling.

Ignore scratch work locally through .git/info/exclude, not shared .gitignore.

Avoid committing temporary files by accident.

Remove blocking nested temp/.gitignore files that contain * or /*.

Stay zero-dependency and fast under npx.

Commands

Initialize

git-temp [directory] [--integrate]

Creates the scratchpad, subfolders, README, and local exclude entry.

Status

git-temp status [directory]

Shows file count, directory count, size, and modified times for files Git now hides.

Clean

git-temp clean [directory] [--force]

Deletes scratchpad contents, then recreates the standard structure.

Integrate

git-temp integrate [directory]

Appends an AI scratchpad guideline to existing instruction files only:

AGENTS.md

CLAUDE.md

.cursorrules

.windsurfrules

.github/copilot-instructions.md

Requirements

Node.js 18+

Git

Run inside a Git repository

About

www.npmjs.com/package/git-temp

Resources

Readme

License

MIT license

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

star

Watchers

watching

Forks

forks

Report repository

Releases

No releases published

Packages

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

JavaScript<br>100.0%

You can’t perform that action at this time.

temp files scratchpad reload status search

Related Articles