kagitch 1.4.0

Kaggle multi-account manager — switch between Kaggle accounts with one command.

kagitch add · kagitch switch · kagitch check

---

Install

pip install git+https://github.com/TQuang122/Kagitch.git
kagitch init        # interactive setup wizard (one time)

Requires pip install kaggle and Python 3.8+.

Windows / PowerShell: kagitch init detects $PROFILE for both PowerShell 5.1 and 7+. Run kagitch init -r to print a . $PROFILE reload command (no os.execv() on Windows).

---

Quick start

kagitch add work      # OAuth login — opens browser
kagitch add personal  # or: kagitch add personal ~/kaggle.json (legacy key)
kagitch 2             # switch to account 2
kagitch check         # check quota for all accounts
kaggle quota          # kaggle CLI follows the switched account
kaggle push kernels -p . # # push current folder as a Kaggle kernel

$ kagitch

╭─────────────────── Dashboard ───────────────────╮
│   Active  #1 account1                           │
│                                                 │
│   Run kagitch switch to choose another account. │
╰─────────────────────────────────────────────────╯
┏━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃   # ┃ Name         ┃  Auth    ┃ Path                         ┃ Status   ┃
┡━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│   1 │ account1     │   OAuth  │  ~/.kaggle-account1          │ ● active │
│   2 │ account2     │   OAuth  │  ~/.kaggle-account2          │          │
│   3 │ account3     │   OAuth  │  ~/.kaggle-account3          │          │
└─────┴──────────────┴──────────┴──────────────────────────────┴──────────┘

---

Commands

Command	Aliases	What it does
kagitch		Show dashboard + active account
kagitch list	ls	List accounts
kagitch <N|name>		Switch to account
kagitch switch [N|name]		Prompt or switch to account
kagitch current	cur, .	Show active account
kagitch add <name>	login	Add account via OAuth
kagitch add <name> <file>		Add account via legacy API key
kagitch remove <N|name>	rm	Remove an account (deletes credentials)
kagitch rename <N> <name>		Rename an account
kagitch patch [path]		Patch kernel-metadata.json id
kagitch check		Check quota & auth for all accounts
kagitch doctor		System diagnostics
kagitch update		Pull latest version from git
kagitch init		Interactive setup wizard (7 steps)
kagitch init -r		Print shell reload command
kagitch completions <sh>		Print shell completion script
kagitch help	-h, --help	Show help
kagitch version	-v, --version	Show version

---

How it works

Each account lives in ~/.kaggle-<name>/.

The shell wrapper sets KAGGLE_CONFIG_DIR when you switch.

Config stored at:

~/.config/kagitch/accounts.json