dirseq

The fastest way to get sequential numbers for your directories. Never manually track file versions again.

~/projects/my-awesome-app
$ mkdir experiment-$(dirseq)
Created directory: experiment-1
$ touch results-$(dirseq).log
Created file: results-2.log
$ dirseq -p 4
0003
$ _

Why Choose dirseq?

Built for developers who value simplicity, speed, and reliability in their workflow automation.

โšก

Blazing Fast

Written in Go with SQLite backend. Get your sequence numbers in milliseconds, not seconds.

๐Ÿ“

Per-Directory Sequences

Each directory maintains its own independent counter. Switch between projects seamlessly.

๐Ÿ’พ

Persistent Memory

Remembers your sequences across sessions. Never lose track of where you left off.

๐ŸŒ

Cross-Platform

Works on Linux, macOS, and Windows. One tool for all your development environments.

๐ŸŽฏ

Zero Configuration

Install and start using immediately. No config files, no setup wizards, just pure productivity.

๐Ÿ”ง

Flexible Padding

Custom padding for consistent file naming. Perfect for ordered file systems.

Perfect For

Real-world scenarios where dirseq shines

๐Ÿงช

Experiment Tracking

Version your ML experiments, A/B tests, and research iterations automatically.

๐Ÿ“ฆ

Build Artifacts

Sequential versioning of builds, releases, and deployment packages.

๐Ÿ“

Log Management

Organize application logs, debug sessions, and output files systematically.

Common Usage Patterns
# Experiment directories
mkdir experiment-$(dirseq)
# Versioned outputs
./build.sh > build-$(dirseq).log
# Padded sequences
touch session-$(dirseq -p 3).txt
# Custom starting point
dirset set-seq 100
dirseq # outputs: 101

Get Started in Seconds

Choose your preferred installation method

Go Install (Recommended)

FASTEST
$ go install github.com/sarkarshuvojit/dirseq@latest

GitHub Releases

BINARY
Download pre-built binaries for your platform
View Releases โ†’
โœ…
Requirements
Go 1.21+ (for go install) or any modern OS (for binaries)