{"id":49052319,"url":"https://github.com/lucatescari/kimbo-terminal","last_synced_at":"2026-05-11T19:00:53.352Z","repository":{"id":351981034,"uuid":"1212574626","full_name":"lucatescari/kimbo-terminal","owner":"lucatescari","description":"A fast, themeable terminal emulator built with Rust and Tauri. Multi-pane layouts, project launcher, and community themes.","archived":false,"fork":false,"pushed_at":"2026-05-04T10:19:54.000Z","size":14357,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-04T12:06:54.289Z","etag":null,"topics":["open-source","rust","tauri2","terminal","typescript","xterm-js"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lucatescari.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-16T14:11:19.000Z","updated_at":"2026-04-29T21:18:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/lucatescari/kimbo-terminal","commit_stats":null,"previous_names":["lucatescari/kimbo-terminal"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/lucatescari/kimbo-terminal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucatescari%2Fkimbo-terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucatescari%2Fkimbo-terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucatescari%2Fkimbo-terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucatescari%2Fkimbo-terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lucatescari","download_url":"https://codeload.github.com/lucatescari/kimbo-terminal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucatescari%2Fkimbo-terminal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32908529,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-11T17:09:15.040Z","status":"ssl_error","status_checked_at":"2026-05-11T17:08:45.420Z","response_time":120,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["open-source","rust","tauri2","terminal","typescript","xterm-js"],"created_at":"2026-04-19T21:10:26.393Z","updated_at":"2026-05-11T19:00:53.325Z","avatar_url":"https://github.com/lucatescari.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kimbo\n\nA fast, themeable terminal emulator built with Rust and Tauri. Multi-pane layouts, tabbed windows, and a command palette for developer workflows.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/lucatescari/kimbo-terminal/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/lucatescari/kimbo-terminal/actions/workflows/ci.yml/badge.svg\" alt=\"CI\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/lucatescari/kimbo-terminal/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/lucatescari/kimbo-terminal?display_name=tag\u0026sort=semver\" alt=\"Latest release\" /\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/lucatescari/kimbo-terminal\" alt=\"License: MIT\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-macOS-lightgrey\" alt=\"Platform: macOS\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/made%20with-%E2%9D%A4-red\" alt=\"Made with love\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"src-ui/public/kimbo_happy.png\" alt=\"Kimbo (happy)\" width=\"128\" /\u003e\n  \u003cimg src=\"src-ui/public/kimbo_normal.png\" alt=\"Kimbo Terminal\" width=\"128\" /\u003e\n  \u003cimg src=\"src-ui/public/kimbo_surprised.png\" alt=\"Kimbo (surprised)\" width=\"128\" /\u003e\n\u003c/p\u003e\n\n\u003e **Beta** — Kimbo is in active development. Expect rough edges. Feedback and contributions welcome.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/kimbo-general.gif\" alt=\"Kimbo general features demo\" width=\"720\" /\u003e\n\u003c/p\u003e\n\n## Features\n\n- **Multi-pane layouts** — split vertically (Cmd+D) or horizontally (Cmd+Shift+D), nest arbitrarily\n- **Tabbed windows** — each tab has its own independent pane layout, drag-and-drop to reorder\n- **Command palette** — unified launcher for commands and projects (Cmd+K)\n- **Find in scrollback** — search terminal output with regex and case-sensitive modes (Cmd+F)\n- **Themeable** — JSON themes (VS Code format), 3 built-in + community theme repo\n- **True color (24-bit)** — full color support for modern CLI tools\n- **Settings UI** — built-in settings panel (Cmd+,) for theme, font, keybindings, workspaces\n- **Configurable keybindings** — all shortcuts customizable via settings or config file\n- **Session restore** — tabs and working directories persist across app restarts\n- **Clickable URLs** — Cmd+click to open links in your browser\n- **Window opacity** — adjustable window transparency\n- **Quit confirmation** — optional prompt before closing active panes\n- **Drag and drop** — drop files and folders directly into the terminal\n- **Welcome screen** — keyboard shortcut intro for first-time users\n- **Native macOS menu bar** — standard app menu with all actions\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/kimbo-cmd-k.gif\" alt=\"Kimbo command palette demo\" width=\"720\" /\u003e\n\u003c/p\u003e\n\n## What's New in `feat/osc1337-inline-images`\n\nThis branch focuses on better media and rendering behavior in the terminal, plus the latest updates merged from `dev`.\n\n- **Inline images (imgcat / OSC 1337)** — renders iTerm-style inline images directly inside the terminal viewport\n- **OSC 1337 cursor-advance preprocessing** — keeps cursor math correct after inline image output (important for tools like `fastfetch`)\n- **Transparent ANSI background filtering** — rewrites problematic black background ANSI sequences to preserve window transparency\n- **Settings and UX additions from `dev`** — includes recent upstream improvements merged from Luca's `dev` branch\n\n### `imgcat`\n\nKimbo's shell init scripts (`kimbo-init.zsh` / `.bash` / `.fish`) define an `imgcat` function that emits the OSC 1337 sequence Kimbo renders. Once you've sourced the init script in your shell rc, it just works:\n\n```bash\nimgcat /path/to/image.png\n```\n\nThe function is skipped if you already have an `imgcat` binary on `PATH` (e.g. iTerm2's bundled one), so it never shadows a richer impl. Kimbo also supports the multipart variant emitted by iTerm2's `imgcat` and by `fastfetch`.\n\n## Tech Stack\n\n- **Rust** — PTY management, config, workspace detection\n- **Tauri 2** — native app shell, IPC between Rust and frontend\n- **xterm.js** — terminal emulation and rendering\n- **TypeScript** — frontend UI (vanilla, no framework)\n\n## Installation\n\n### Build from Source\n\nRequires: [Rust](https://rustup.rs/), [Node.js](https://nodejs.org/) (v18+), [Tauri CLI](https://tauri.app/)\n\n```bash\ngit clone https://github.com/lucatescari/kimbo-terminal.git\ncd kimbo-terminal\nnpm install\ncargo install tauri-cli --version \"^2\"\n```\n\n**Development:**\n```bash\nnpm start\n```\n\n**Production build (signed .app + .dmg on macOS):**\n```bash\nnpm run build\n```\n\nThe built app is at `target/release/bundle/macos/Kimbo.app`.\n\n### Download\n\nmacOS builds will be available on the [Releases](https://github.com/lucatescari/kimbo-terminal/releases) page soon.\n\n## Configuration\n\nConfig file: `~/.config/kimbo/config.toml`\n\n```toml\n[general]\ndefault_shell = \"/bin/zsh\"\n\n[font]\nfamily = \"JetBrains Mono\"\nsize = 14.0\nline_height = 1.2\nligatures = true\n\n[theme]\nname = \"kimbo-dark\"\n\n[scrollback]\nlines = 10000\n\n[cursor]\nstyle = \"block\"\nblink = true\n\n[workspace]\nauto_detect = true\nscan_dirs = [\"~/Projects\"]\n```\n\nOr use the built-in settings UI (Cmd+,).\n\n## Keybindings\n\n| Shortcut | Action |\n|---|---|\n| Cmd+K | Command palette |\n| Cmd+T | New tab |\n| Cmd+Shift+W | Close tab |\n| Cmd+D | Split vertically |\n| Cmd+Shift+D | Split horizontally |\n| Cmd+W | Close pane |\n| Cmd+Arrow | Navigate between panes |\n| Cmd+] / Cmd+[ | Next / previous tab |\n| Cmd+1-9 | Switch to tab by number |\n| Cmd+F | Find in scrollback |\n| Cmd+, | Settings |\n| Cmd+Q | Quit |\n\nAll keybindings are customizable in Settings \u003e Keybindings.\n\n## Themes\n\nKimbo uses JSON themes in VS Code format. Three built-in themes are included:\n\n- **Kimbo Dark** — default dark theme\n- **Catppuccin Mocha** — warm dark pastels\n- **Catppuccin Latte** — warm light pastels\n\nCommunity themes are available in Settings \u003e Appearance. You can also create your own — see the [kimbo-themes](https://github.com/lucatescari/kimbo-themes) repo for the format and how to contribute.\n\nInstall custom themes by placing `.json` files in `~/.config/kimbo/themes/`.\n\n## Scripts\n\n| Command | Description |\n|---|---|\n| `npm start` | Run in development mode |\n| `npm run build` | Production build (.app + .dmg) |\n| `npm test` | Run frontend tests |\n| `npm run test:rust` | Run Rust tests |\n| `npm run test:all` | Run all tests |\n\n## Project Structure\n\n```\nkimbo-terminal/\n  src-tauri/          # Rust backend (Tauri app, PTY management, commands)\n  src-ui/             # TypeScript frontend (xterm.js, tabs, settings, etc.)\n  crates/\n    kimbo-terminal/   # Raw PTY wrapper (spawn, read/write, resize, CWD)\n    kimbo-config/     # Config loading, JSON themes, keybinding definitions\n    kimbo-workspace/  # Project detection and directory scanning\n```\n\n## Platform Support\n\n- **macOS** — primary platform, fully supported\n- **Linux** — planned\n- **Windows** — planned\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucatescari%2Fkimbo-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucatescari%2Fkimbo-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucatescari%2Fkimbo-terminal/lists"}