{"id":44152457,"url":"https://github.com/tw93/kaku","last_synced_at":"2026-02-28T13:12:56.948Z","repository":{"id":337024651,"uuid":"1152157239","full_name":"tw93/Kaku","owner":"tw93","description":"🎃 A fast, out-of-the-box terminal built for AI coding.","archived":false,"fork":false,"pushed_at":"2026-02-13T11:33:46.000Z","size":19344,"stargazers_count":948,"open_issues_count":6,"forks_count":38,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-02-13T12:08:46.263Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tw93.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"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-02-07T13:00:49.000Z","updated_at":"2026-02-13T12:08:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tw93/Kaku","commit_stats":null,"previous_names":["tw93/kaku"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/tw93/Kaku","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tw93%2FKaku","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tw93%2FKaku/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tw93%2FKaku/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tw93%2FKaku/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tw93","download_url":"https://codeload.github.com/tw93/Kaku/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tw93%2FKaku/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29438641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T05:24:35.651Z","status":"ssl_error","status_checked_at":"2026-02-14T05:24:34.830Z","response_time":53,"last_error":"SSL_read: 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":[],"created_at":"2026-02-09T04:13:33.710Z","updated_at":"2026-02-28T13:12:56.930Z","avatar_url":"https://github.com/tw93.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eKaku\u003c/h1\u003e\n  \u003cp\u003e\u003cem\u003eA fast, out-of-the-box terminal built for AI coding.\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/tw93/Kaku/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/tw93/Kaku?style=flat-square\" alt=\"Stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/tw93/Kaku/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/tag/tw93/Kaku?label=version\u0026style=flat-square\" alt=\"Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/tw93/Kaku/commits\"\u003e\u003cimg src=\"https://img.shields.io/github/commit-activity/m/tw93/Kaku?style=flat-square\" alt=\"Commits\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://twitter.com/HiTw93\"\u003e\u003cimg src=\"https://img.shields.io/badge/follow-Tw93-red?style=flat-square\u0026logo=Twitter\" alt=\"Twitter\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/kaku.jpeg\" alt=\"Kaku Screenshot\" width=\"1000\" /\u003e\n  \u003cbr/\u003e\n  Kaku is a deeply customized fork of \u003ca href=\"https://github.com/wez/wezterm\"\u003eWezTerm\u003c/a\u003e, designed for an out-of-the-box experience.\n\u003c/p\u003e\n\n## Features\n\n- **Zero Config**: Defaults with JetBrains Mono, opencode theme, macOS font rendering, and low-res font sizing.\n- **Curated Shell Suite**: Built-in zsh plugins with optional CLI tools for prompt, diff, and navigation workflows.\n- **Fast \u0026 Lightweight**: 40% smaller binary, instant startup, lazy loading, stripped-down GPU-accelerated core.\n- **WezTerm-Compatible Config**: Use WezTerm's Lua config directly with full API compatibility and no migration.\n\n## Quick Start\n\n1. [Download Kaku DMG](https://github.com/tw93/Kaku/releases/latest) \u0026 Drag to Applications\n2. Or install with Homebrew: `brew install tw93/tap/kakuku`\n3. Open Kaku. The app is notarized by Apple, so it opens without security warnings\n4. On first launch, Kaku will automatically set up your shell environment\n\n## Usage Guide\n\nKaku comes with intuitive macOS-native shortcuts:\n\n| Action | Shortcut |\n| :--- | :--- |\n| Toggle Global Window | `Cmd + Opt + Ctrl + K` |\n| New Tab | `Cmd + T` |\n| New Window | `Cmd + N` |\n| Close Tab/Pane | `Cmd + W` |\n| Navigate Tabs | `Cmd + Shift + [`, `Cmd + Shift + ]` or `Cmd + 1-9` |\n| Navigate Panes | `Cmd + Opt + Arrows` |\n| Split Pane Vertical | `Cmd + D` |\n| Split Pane Horizontal | `Cmd + Shift + D` |\n| Toggle Split Direction | `Cmd + Shift + S` |\n| Zoom/Unzoom Pane | `Cmd + Shift + Enter` |\n| Resize Pane | `Cmd + Ctrl + Arrows` |\n| Clear Screen | `Cmd + K` |\n| Doctor Panel | `Ctrl + Shift + L` |\n| Kaku AI Settings | `Cmd + Shift + A` |\n| Kaku Assistant Apply Suggestion | `Cmd + Shift + E` |\n| Open Lazygit | `Cmd + Shift + G` |\n| Yazi File Manager | `Cmd + Shift + Y` or `y` |\n| Font Size | `Cmd + +`, `Cmd + -`, `Cmd + 0` |\n| Smart Jump | `z \u003cdir\u003e` |\n| Smart Select | `z -l \u003cdir\u003e` |\n| Recent Dirs | `z -t` |\n\n### Intuitive Interactions\n\n- **Visual Bell**: A blinking dot appears on inactive tabs when background tasks finish.\n- **Active Pane**: A subtle dot highlights the currently focused pane during split-screen workflows.\n- **Global Hotkey**: Press `Cmd + Opt + Ctrl + K` anytime to float Kaku over your current workspace.\n- **Copy on Select**: Highlighting any text automatically copies it to your clipboard with a confirmation toast.\n- **Zoom Window**: Double-click the title bar or tab bar empty space to safely zoom or unzoom the window.\n- **Finder Integration**: Right-click folders in macOS Finder and deploy Kaku via Services, or drop multiple files directly onto the Kaku Dock icon.\n- **History Peek**: Scroll up while inside full-screen apps like `less` or `vim` to lift the screen and peek at your primary shell history without exiting.\n\n## Configuration\n\nKaku comes with a carefully curated shell stack for immediate productivity, so you can focus on AI coding without opening vscode:\n\nBuilt-in zsh plugins bundled by default:\n\n- **z**: A smarter cd command that learns your most used directories for instant navigation.\n- **zsh-completions**: Extended command and subcommand completion definitions.\n- **Syntax Highlighting**: Real-time command validation and coloring.\n- **Autosuggestions**: Intelligent, history-based completions similar to Fish shell.\n\nOptional CLI tools installed via Homebrew during `kaku init`:\n\n- **Starship**: A fast, customizable prompt showing git status, package versions, and execution time.\n- **Delta**: A syntax-highlighting pager for git, diff, and grep output.\n- **Lazygit**: A terminal UI for fast, visual Git workflows without leaving the shell.\n- **Yazi**: A terminal file manager. Use `y` to launch it and sync the shell directory on exit.\n\nKaku uses `~/.config/kaku/kaku.lua` for configuration, fully compatible with WezTerm's Lua API, with built-in defaults at `Kaku.app/Contents/Resources/kaku.lua` as fallback.\n\nRun `kaku` in your terminal to see all available commands such as `kaku ai`, `kaku config`, `kaku doctor`, `kaku update`, and `kaku reset`.\n\n## Kaku AI\n\nKaku includes a built-in assistant for command-line error recovery and a unified settings UI for external AI coding tools.\n\n- **Kaku Assistant**: Automatically analyzes failed commands and prepares a safe command suggestion.\n- **AI Tools Config**: Manage settings for tools like Claude Code, Codex, Gemini CLI, Copilot CLI, Factory Droid, OpenCode, and OpenClaw.\n\nOpen AI settings with `kaku ai`, then configure **Kaku Assistant** (enable, model, base URL, API key) and your external AI tools in one place.\n\nTip: DeepSeek-V3.2 is a great low-cost option to start with for everyday AI coding tasks.\n\nWhen Kaku Assistant has a suggestion ready after a command error, press `Cmd + Shift + E` to apply it.\n\n## Why Kaku?\n\nI heavily rely on the CLI for both work and personal projects. Tools I've built, like [Mole](https://github.com/tw93/mole) and [Pake](https://github.com/tw93/pake), reflect this.\n\nI used Alacritty for years and learned to value speed and simplicity. As my workflow shifted toward AI-assisted coding, I wanted stronger tab and pane ergonomics. I also explored Kitty, Ghostty, Warp, and iTerm2. Each is strong in different areas, but I still wanted a setup that matched my own balance of performance, defaults, and control.\n\nWezTerm is robust and highly hackable, and I am grateful for its engine and ecosystem. Kaku builds on that foundation with practical defaults for day one use, while keeping full Lua-based customization and a fast, lightweight feel.\n\nSo I built Kaku to be that environment: fast, polished, and ready to work.\n\n### Performance\n\n| Metric | Upstream | Kaku | Methodology |\n| :--- | :--- | :--- | :--- |\n| **Executable Size** | ~67 MB | ~40 MB | Aggressive symbol stripping \u0026 feature pruning |\n| **Resources Volume** | ~100 MB | ~80 MB | Asset optimization \u0026 lazy-loaded assets |\n| **Launch Latency** | Standard | Instant | Just-in-time initialization |\n| **Shell Bootstrap** | ~200ms | ~100ms | Optimized environment provisioning |\n\nAchieved through aggressive stripping of unused features, lazy loading of color schemes, and shell optimizations.\n\n## FAQ\n\n1. **Is there a Windows or Linux version?**\n\n   Not at the moment. Kaku is currently macOS-only while we focus on polishing the macOS experience. Windows and Linux versions may come later once the macOS version is mature.\n\n2. **Can Kaku use transparent windows on macOS?**\n\n   Yes. You can set `window_background_opacity` and optionally `macos_window_background_blur` in `~/.config/kaku/kaku.lua`. Transparent mode now keeps top/right/bottom padding regions visually consistent to avoid transparent gaps.\n\n3. **How do I turn off copy on select?**\n\n   Kaku enables copy on select by default; to disable automatic clipboard copy and copy toast after selection, add `config.copy_on_select = false` to `~/.config/kaku/kaku.lua`.\n\n4. **Can I control working directory inheritance separately for new window, tab, and split?**\n\n   Yes. Use these options in `~/.config/kaku/kaku.lua`:\n   `config.window_inherit_working_directory`\n   `config.tab_inherit_working_directory`\n   `config.split_pane_inherit_working_directory`\n   All are enabled by default.\n\n5. **The `kaku` command is missing. How can I recover it and troubleshoot with Kaku Doctor?**\n\n   Open Kaku Doctor from the Shell menu first. This diagnostic path can still run when your shell command entry is missing and will tell you what to repair.\n\n   Then run this command in a terminal to restore the shell entry:\n\n   ```bash\n   /Applications/Kaku.app/Contents/MacOS/kaku init --update-only\n   exec zsh -l\n   ```\n\n   Finally run `kaku doctor` in your terminal to verify everything is healthy.\n\n6. **How can I use Kaku's CLI capabilities (like `split-pane`) from other scripts or tools?**\n\n   Kaku exposes a powerful CLI for interacting with its multiplexer. For example, to split the current pane, run:\n\n   ```bash\n   kaku cli split-pane\n   ```\n\n   To split it and run a specific command instead of your default shell:\n\n   ```bash\n   kaku cli split-pane -- bash -c \"echo Hello\"\n   ```\n\n   You can explore all available CLI commands by running `kaku cli --help` or specifically `kaku cli split-pane --help`. This is very useful when integrating Kaku with workflows or AI tools.\n\n## Contributors\n\nBig thanks to all contributors who helped build Kaku. Go follow them! ❤️\n\n\u003ca href=\"https://github.com/tw93/Kaku/graphs/contributors\"\u003e\n  \u003cimg src=\"./CONTRIBUTORS.svg?v=2\" width=\"1000\" /\u003e\n\u003c/a\u003e\n\n## Support\n\n- If Kaku helped you, star the repo or [share it](https://twitter.com/intent/tweet?url=https://github.com/tw93/Kaku\u0026text=Kaku%20-%20A%20fast%20terminal%20built%20for%20AI%20coding.) with friends.\n- Got ideas or found bugs? Open an issue/PR or check [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n- Like Kaku? \u003ca href=\"https://miaoyan.app/cats.html?name=Kaku\" target=\"_blank\"\u003eBuy Tw93 a Coke\u003c/a\u003e to support the project! 🥤 Supporters below.\n\n\u003ca href=\"https://miaoyan.app/cats.html?name=Kaku\"\u003e\u003cimg src=\"https://miaoyan.app/assets/sponsors.svg\" width=\"1000\" loading=\"lazy\" /\u003e\u003c/a\u003e\n\n## License\n\nMIT License, feel free to enjoy and participate in open source.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftw93%2Fkaku","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftw93%2Fkaku","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftw93%2Fkaku/lists"}