dexter/BTerminal
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
3 commits 3 branches 0 tags 1.9 MiB
Find a file
DexterFromLab a8b8548346 Add ctx project management to Claude Code session dialog 
- Project dir field with Browse button in ClaudeCodeDialog
- Auto-fill session name and ctx prompt when selecting directory
- Auto-initialize ctx project and generate CLAUDE.md on session save
- CtxEditDialog for managing ctx entries (add/edit/delete key-value pairs)
- Edit ctx accessible from dialog button and right-click context menu
- Claude Code sessions now spawn in project directory instead of HOME

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 12:49:10 +01:00
.gitignore Add ctx context manager, installer, and auto-detect Claude path 2026-03-05 11:54:24 +01:00
bterminal.py Add ctx project management to Claude Code session dialog 2026-03-05 12:49:10 +01:00
ctx Add ctx context manager, installer, and auto-detect Claude path 2026-03-05 11:54:24 +01:00
install.sh Add ctx context manager, installer, and auto-detect Claude path 2026-03-05 11:54:24 +01:00
README.md Add ctx context manager, installer, and auto-detect Claude path 2026-03-05 11:54:24 +01:00
screenshot.png Initial commit: BTerminal — GTK3 terminal with SSH & Claude Code session management 2026-03-04 18:34:36 +01:00

README.md

BTerminal

Terminal with session panel (MobaXterm-style), built with GTK 3 + VTE. Catppuccin Mocha theme.

BTerminal

Features

  • SSH sessions — saved configs (host, port, user, key, folder, color), CRUD with side panel
  • Claude Code sessions — saved Claude Code configs with sudo, resume, skip-permissions and initial prompt
  • SSH macros — multi-step macros (text, key, delay) assigned to sessions, run from sidebar
  • Tabs — multiple terminals in tabs, Ctrl+T new, Ctrl+Shift+W close, Ctrl+PageUp/Down switch
  • Sudo askpass — Claude Code with sudo: password entered once, temporary askpass helper, auto-cleanup
  • Folder grouping — SSH and Claude Code sessions can be grouped in folders on the sidebar
  • ctx — Context manager — SQLite-based cross-session context database for Claude Code projects
  • Catppuccin Mocha — full theme: terminal, sidebar, tabs, session colors

Installation

git clone https://github.com/DexterFromLab/BTerminal.git
cd BTerminal
./install.sh

The installer will:

  1. Install system dependencies (python3-gi, GTK3, VTE)
  2. Copy files to ~/.local/share/bterminal/
  3. Create symlinks: bterminal and ctx in ~/.local/bin/
  4. Initialize context database at ~/.claude-context/context.db
  5. Add desktop entry to application menu

Manual dependency install (Debian/Ubuntu/Pop!_OS)

sudo apt install python3-gi gir1.2-gtk-3.0 gir1.2-vte-2.91

Usage

bterminal

Context Manager (ctx)

ctx is a SQLite-based tool for managing persistent context across Claude Code sessions.

ctx init myproject "Project description" /path/to/project
ctx get myproject                    # Load full context (shared + project)
ctx set myproject key "value"        # Save a context entry
ctx shared set preferences "value"   # Save shared context (available in all projects)
ctx summary myproject "What was done" # Save session summary
ctx search "query"                   # Full-text search across everything
ctx list                             # List all projects
ctx history myproject                # Show session history
ctx --help                           # All commands

Integration with Claude Code

Add a CLAUDE.md to your project root:

On session start, load context:
  ctx get myproject

Save important discoveries: ctx set myproject <key> <value>
Before ending session: ctx summary myproject "<what was done>"

Claude Code reads CLAUDE.md automatically and will maintain the context database.

Configuration

Config files in ~/.config/bterminal/:

File Description
sessions.json Saved SSH sessions + macros
claude_sessions.json Saved Claude Code configs

Context database: ~/.claude-context/context.db

Keyboard Shortcuts

Shortcut Action
Ctrl+T New tab (local shell)
Ctrl+Shift+W Close tab
Ctrl+Shift+C Copy
Ctrl+Shift+V Paste
Ctrl+PageUp/Down Previous/next tab

License

MIT