42TUI

Your 42 projects, notes, and coding activity in the terminal. Connect your 42 account, track time with editor plugins, and jump to project folders with 42goto.

Features

• Browse projects, read subjects, open your editor, and run supported testers.
• Keep project notes and coding activity locally, available offline.
• Track coding time with plugins for Vim, Neovim, VS Code, and Zed.
• Jump to local projects with 42goto, with shell completion.
• Follow account progress, manage correction slots, and explore your campus's cluster map.
• Follow friends and join club conversations and events.

Account and campus features require a connected 42 account and available data. Some project testers require Docker.

Install and launch

For Linux (glibc) and macOS, on x86_64 or ARM64:

curl -fsSL https://tui.42wip.in/install.sh | sh

You can inspect the installer first. It needs curl, internet access, and a writable home directory. It installs uv and Python 3.12 if needed, without administrator rights.

Restart your terminal, then run:

42tui

Connect your 42 account

1. Choose Connect 42 account during setup, or open Settings → Profile with F5.
2. Choose Connect / reconnect, then sign in and approve access in your browser. If no browser opens, use Copy login link to open it yourself.
3. Return to 42TUI and finish setup: projects folder, editor, theme, and language.

Your project list loads after connection. To change cursus, open Settings → Curriculum → Default cursus. You can skip connection and work with saved projects and local notes.

Your password stays with 42; device credentials use your OS credential store.

42goto

Configure your project's local folder in 42TUI, then enable shell navigation. Add the matching line to your shell config:

# Zsh: ~/.zshrc, after compinit
eval "$(command 42goto --shell-init zsh)"

# Bash: ~/.bashrc
eval "$(command 42goto --shell-init bash)"

Restart your shell, then jump to a project:

42goto libft
42goto          # Use the active or most recently tracked project

Press Tab to complete project slugs. Local folders must exist. If 42goto cannot choose a project automatically, pass its name or slug.

Editor plugins

Configure each project's local folder in 42TUI, then install your editor's plugin:

• Vim
• Neovim
• VS Code — development extension setup
• Zed — development extension setup

The plugins call 42tui heartbeat locally as you work. Make sure your editor can find 42tui on its PATH, or set the executable path in the plugin. Tracking needs no account connection; file contents are not read and file paths are not retained.

Everyday use

Press ? or F1 for shortcuts. F2 opens Projects, F3 opens Notes, and F5 opens Settings.

For installer-managed installations:

42tui update
42tui uninstall

Uninstalling preserves local data and credentials. To disconnect first, choose Settings → Profile → Manage 42 account → Disconnect this device. Other installations should be maintained with their original package manager.

If 42tui is not found, restart your terminal and check the installer's printed executable directory is on your PATH. If icons look wrong, select a Nerd Font in your terminal settings.

For development setup, see CONTRIBUTING.md.