dexter/BTerminal
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
37 commits 3 branches 0 tags 1.9 MiB
Find a file
Hibryda 4db7ccff60 feat(v2): add SSH management, ctx integration, themes, detached mode, auto-updater 
SSH session management:
- SshSession struct + ssh_sessions SQLite table in session.rs
- CRUD Tauri commands (ssh_session_list/save/delete) in lib.rs
- SshDialog.svelte (create/edit modal), SshSessionList.svelte (sidebar)
- SSH pane routes to TerminalPane with shell=/usr/bin/ssh + args

ctx context database integration:
- ctx.rs: read-only CtxDb (SQLITE_OPEN_READ_ONLY for ~/.claude-context/context.db)
- 5 Tauri commands (ctx_list_projects/get_context/get_shared/get_summaries/search)
- ContextPane.svelte with project selector, tabs, search
- ctx-bridge.ts adapter

Catppuccin theme flavors (Latte/Frappe/Macchiato/Mocha):
- themes.ts: all 4 palette definitions + buildXtermTheme/applyCssVariables
- theme.svelte.ts: reactive store with SQLite persistence
- SettingsDialog flavor dropdown, TerminalPane theme-aware

Detached pane mode (pop-out windows):
- detach.ts: isDetachedMode/getDetachedConfig from URL params
- App.svelte: conditional rendering of single pane without chrome

Other additions:
- Shiki syntax highlighting (highlight.ts, lazy singleton, 13 languages)
- Tauri auto-updater plugin (tauri-plugin-updater + updater.ts)
- AgentPane markdown rendering with Shiki code highlighting
- New deps: shiki, @tauri-apps/plugin-updater, tauri-plugin-updater
2026-03-06 14:50:00 +01:00
.claude chore: update README, TODO, and CHANGELOG for Phase 6 completion 2026-03-06 14:23:24 +01:00
.github/workflows feat(v2): add packaging, installer, and CI release workflow (Phase 6) 2026-03-06 14:23:09 +01:00
.vscode chore: add VS Code workspace config with Peacock color 2026-03-05 23:14:39 +01:00
docs docs: update all docs for Phase 6 packaging completion 2026-03-06 14:23:16 +01:00
v2 feat(v2): add SSH management, ctx integration, themes, detached mode, auto-updater 2026-03-06 14:50:00 +01:00
.gitignore chore: add project meta files and Claude behavioral guide 2026-03-05 22:49:20 +01:00
bterminal.py Migrate to Gtk.Application for proper app lifecycle and custom icon 2026-03-05 13:12:30 +01:00
bterminal.svg Add bterminal icon to installer and desktop entry 2026-03-05 13:25:03 +01:00
CHANGELOG.md chore: update README, TODO, and CHANGELOG for Phase 6 completion 2026-03-06 14:23:24 +01:00
CLAUDE.md chore: update README, TODO, and CHANGELOG for Phase 6 completion 2026-03-06 14:23:24 +01:00
ctx Add ctx context manager, installer, and auto-detect Claude path 2026-03-05 11:54:24 +01:00
install-v2.sh feat(v2): add packaging, installer, and CI release workflow (Phase 6) 2026-03-06 14:23:09 +01:00
install.sh Add bterminal icon to installer and desktop entry 2026-03-05 13:25:03 +01:00
README.md chore: update README, TODO, and CHANGELOG for Phase 6 completion 2026-03-06 14:23:24 +01:00
screenshot.png Update screenshot with current UI showing Claude Code session 2026-03-05 13:26:53 +01:00
TODO.md chore: update README, TODO, and CHANGELOG for Phase 6 completion 2026-03-06 14:23:24 +01:00

README.md

BTerminal

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

v2 all phases complete: Multi-session Claude agent dashboard using Tauri 2.x + Svelte 5. Features: multi-pane terminal with PTY backend, agent panes with structured output and tree visualization, SQLite session persistence with layout restore, live markdown file viewer, global status bar with cost tracking, toast notifications, settings dialog, CSS Grid tiling, Catppuccin theme, .deb + AppImage packaging, and GitHub Actions CI. Branch v2-mission-control. See docs/task_plan.md for architecture and docs/phases.md for implementation plan.

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

v2 Installation (Tauri — build from source)

Requires Node.js 20+, Rust 1.77+, and system libraries (WebKit2GTK 4.1, GTK3, etc.).

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

The installer checks all dependencies, offers to install missing system packages via apt, builds the Tauri app, and installs the binary as bterminal-v2 in ~/.local/bin/.

Pre-built .deb and AppImage packages are available from GitHub Releases (built via CI on version tags).

v1 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

Documentation

Document Description
docs/task_plan.md v2 architecture decisions, error handling, testing strategy
docs/phases.md v2 implementation phases (1-6) with checklists
docs/findings.md Research findings (Agent SDK, Tauri, xterm.js, performance)
docs/progress.md Session-by-session progress log

License

MIT