dotfiles

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 54 Open GitHub ↗

Personal configuration files managed with GNU Stow for easy deployment and version control.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<br/>

> _"your terminal is where you live. make it beautiful."_

<br/>

</div>

---

```
          zsh  ·  vscode  ·  kitty  ·  starship  ·  git  · gh
```

</div>

---

<br/>

## `⚡ one command. everything.`

</div>

<br/>

```bash
git clone https://github.com/GourangaDasSamrat/dotfiles.git ~/dotfiles
cd ~/dotfiles/scripts && ./install.sh
```

_detects your os · installs every tool · symlinks every config · done_

</div>

<br/>

> want control? `./setup.sh` lets you pick exactly what to run.

---

<br/>

## `🐚 shell`

_built around fzf. everything has a live preview._
_every command feels intentional._

</div>

<br/>

</div>

---

<br/>

## `🪟 tmux`

_catppuccin macchiato · live weather in the status bar_
_sessions that survive reboots_

</div>

<br/>

```
  prefix      ctrl+a            splits        |  and  -
  navigate    h · j · k · l     windows       alt + 1–5
  mouse       on                persist       auto-save every 5 min
```

<br/>

tmux-resurrect + tmux-continuum restore your exact layout,
panes, and working directories after every reboot.

</div>

---

<br/>

## `🖥️ vs code`

_six language profiles · italic keywords · ligatures · snippets_

</div>

<br/>

</div>

<br/>

font stack → **Operator Mono** · Cartograph CF · JetBrains Mono — with italic keywords and full ligatures.

snippets for **C++** (main, competitive programming, leetcode template) and **Go** (main, package, `iferr`, interface).

---

<br/>

## `🔧 git`

_conventional commits enforced · clean aliases · nothing slips through_

</div>

<br/>

a `commit-msg` hook blocks any message that doesn't match `type(scope): subject`.
you get a clear error, valid types, and examples — every time.
a `pre-push` hook blocks push without password, you can expose the password on you shell script nameed with ,`GIT_PUSH_PASS`.

<br/>

```bash
git lg           # pretty graph log
git today        # commits since midnight
git yesterday    # yesterday's commits
git mine         # your commits only
git undo         # soft reset the last commit
git unstage      # unstage all staged files
git last         # full detail of the last commit
```

---

<br/>

## `🔧 github cli`

_clean aliases · nothing slips through_

</div>

<br/>

```bash
# --- Present (Current Activity) ---
gh today              # Every commit with timestamps since midnight (all repos)
gh today-summary      # Repo-wise summary + total commit count for today
gh today-stats        # Full profile-style contributions for today
gh this-month-summary # Accurate monthly report (handles 1000+ commits)
gh this-month-stats   # Full profile-style contributions for this month
gh this-year-summary  # Total commits this year (handles 1200+ accurately)
gh this-year-stats    # Full profile-style contributions for this year
gh this-year-languages # Top 5 languages used this year (by bytes)
gh streak             # Calculate your current and longest commit streak

# --- Past (Historical Activity) ---
gh yesterday          # Every commit with timestamps from yesterday (all repos)
gh yesterday-summary  # Repo-wise summary + total commit count for yesterday
gh yesterday-stats    # Full profile-style contributions for yesterday
gh last-month-summary # Accurate monthly report for previous month
gh last-month-stats   # Full profile-style contributions for last month
gh last-year-summary  # Full contribution summary for the previous year
gh last-year-stats    # Full profile-style contributions for last year
gh last-year-languages # Top 5 languages used in the previous year

# --- Utilities ---
gh prs                # Your PRs in the current repo with status
gh open               # Open the current repo in your default browser
gh co                 # Interactive PR checkout

```

---

<br/>

## `🎨 terminal & prompt`

_kitty · starship_

</div>

<br/>

**Starship** — two-line prompt. directory + git on line one. language modules inline — node, go, python, rust, java, and more. shows vs code version in any directory.

---

<br/>

## `📦 what gets installed`

</div>

<br/>

</div>

---

<br/>

## `🏗️ scripts architecture`

</div>

<br/>

### **Quick Start**

```bash
# automated — install everything
./install.sh

# interactive — choose what to run
./setup.sh
```

</div>

<br/>

### **Folder Structure**

```
scripts/
├── install.sh              full automated setup (runs lib/ scripts)
├── setup.sh                interactive menu — pick and choose
│
├── lib/                    modular setup scripts (standalone)
│   ├── softwares.sh        install base tools & language runtimes
│   ├── plugins.sh          oh-my-zsh · tpm · zsh & tmux plugins
│   ├── wallpapers.sh       clone wallpapers repository
│   ├── fonts.sh            use apples's font on linux
│   └── dotfiles.sh         symlink configs with gnu stow
│
├── sdk-tools/              optional language-specific installers
│   ├── cargo-tools.sh      rust cli tools (cargo-watch, cargo-cache, etc.)
│   ├── go-tools.sh         go dev tools (gopls, golangci-lint, goreleaser, etc.)
│   └── uv-tools.sh         python cli tools via uv package manager
│
├── utils/
│   └── detect.sh           os · package manager · sudo detection
│
└── config/
    └── wallpapers.url      wallpapers repository url
```

_Every script in `lib/` and `sdk-tools/` runs standalone. Source only what you need._

</div>

---

<br/>

### **Usage Modes**

<br/>

**`./install.sh`** — Full automated setup

- runs `lib/softwares.sh` → base tools + language runtimes
- runs `lib/plugins.sh` → shell plugins
- runs `lib/wallpapers.sh` → wallpapers repo
- runs `lib/fonts.sh` → apple fonts
- runs `lib/dotfiles.sh` → symlink configs
- ⏭️ skips optional sdk-tools

**`./setup.sh`** — Interactive menu

- displays all available scripts (lib/ + sdk-tools/)
- you choose which ones to run
- includes optional language tools (Go, Rust, Python)

**Optional Language Tools** — Run individually

```bash
./sdk-tools/go-tools.sh       # install go dev tools
./sdk-tools/cargo-tools.sh    # install rust cli tools (requires cargo)
./sdk-tools/uv-tools.sh       # install python tools (requires uv)
```

Add `--update` flag to force reinstall: `./sdk-tools/go-tools.sh --update`

</div>

---

<br/>

## `📚 documentation`

</div>

<br/>

</div>

---

<br/>

## `⚙️ prerequisites`

**git** &nbsp;·&nbsp; **homebrew** _(macOS only)_ — [brew.sh](https://brew.sh)

</div>

---

<br/>

**Gouranga Das Samrat**
<br/>
_Software Developer_

<br/>

[![GitHub](https://img.shields.io/badge/@GourangaDasSamrat-1a1a2e?style=for-the-badge&logo=github&logoColor=bd93f9)](https://github.com/GourangaDasSamrat)&nbsp;
[![Email](https://img.shields.io/badge/gouranga.samrat@gmail.com-1a1a2e?style=for-the-badge&logo=gmail&logoColor=ff79c6)](mailto:gouranga.samrat@gmail.com)&nbsp;
[![Issues](https://img.shields.io/badge/report%20a%20bug-1a1a2e?style=for-the-badge&logo=github&logoColor=50fa7b)](https://github.com/GourangaDasSamrat/dotfiles/issues)

<br/>

_if this made your terminal feel like home — drop a_ ⭐

</div>

dotfiles

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README