Skip to content

Commit 9588eb3

Browse files
codekilncodekiln
committed
docs: Add Vibe Kanban tool and tmux tutorials to knowledge garden
- Created a new page for "Vibe Kanban," detailing its features, concerns, and installation steps for orchestrating AI coding agents - Added a journal entry linking to the Vibe Kanban page and related tmux resources - Introduced a tutorial on using tmux as a Kanban board for agentic coding, outlining essential commands and workflow patterns
1 parent b0c9cd8 commit 9588eb3

File tree

5 files changed

+211
-2
lines changed

5 files changed

+211
-2
lines changed

‎journals/2025_11_30.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
## [[AI Coding]]
2+
- [[tmux/Cheat Sheet]]
3+
- [[tmux/Tutorial/Kanban for Agentic Coding]]
4+
- [[tmux/setw]]
5+
- [[AI/Coding/Tool/Vibe Kanban]] - Platform for orchestrating AI coding agents with visual kanban board, parallel execution, and streamlined code reviews

‎pages/AI___Coding___Tool___Vibe Kanban.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
tags:: [[AI Coding]], [[Tool]]
2+
3+
- # [Vibe Kanban - Orchestrate AI Coding Agents](https://www.vibekanban.com/)
4+
- ## Overview
5+
- Platform designed to orchestrate AI coding agents, enabling developers to run multiple agents in parallel, manage tasks visually, and streamline code reviews
6+
- Integrates with various AI coding agents such as [[Claude Code]], [[OpenAI/Codex]], [[GitHub/CoPilot]], and others
7+
- Claims to be open source and built by developers for developers
8+
- ## Concerns / Risks
9+
- ### Not Actually Open Source
10+
- Some Reddit users complain that despite claims of being "open source," the tool is distributed as a compiled binary
11+
- The source code is not publicly available or auditable
12+
- This raises security concerns as users cannot verify what the binary actually does
13+
- ### Security Implications
14+
- Running compiled binaries from unknown sources is considered dangerous, especially for tools that interact with codebases and AI agents
15+
- Without source code access, users cannot audit for:
16+
- Malicious code
17+
- Data exfiltration
18+
- Unauthorized access to codebases or AI credentials
19+
- Backdoors or other security vulnerabilities
20+
- ## Key Features
21+
- ### Multi-Agent Orchestration
22+
- Run multiple AI coding agents simultaneously
23+
- Assign different tasks to specialized agents to enhance productivity
24+
- ### Visual Task Management
25+
- Intuitive kanban board to track each AI agent's progress
26+
- Clear overview of tasks in progress, ready for review, or completed
27+
- ### Seamless Code Review
28+
- Review AI-generated code directly within the interface
29+
- Start development servers, test changes, and merge confidently—all from one place
30+
- ### Centralized Configuration
31+
- Manage all AI agent configurations in a single location
32+
- Eliminates the need to switch between tools or track multiple settings
33+
- ### Parallel Workflows
34+
- Execute tasks in parallel or sequence
35+
- Allows AI agents to handle routine work while developers focus on architecture and complex problems
36+
- ## Getting Started
37+
- ### Installation
38+
- Requires Node.js 18+
39+
- Install via: `npx vibe-kanban`
40+
- ### Setup Steps
41+
1. Connect your preferred AI coding agents (Claude Code, Gemini CLI, Codex, etc.)
42+
2. Create tasks on your kanban board
43+
3. Assign tasks to appropriate AI agents
44+
4. Review code, merge changes, and deploy
45+
- ## Documentation
46+
- [Vibe Kanban Documentation](https://www.vibekanban.com/docs)
47+
- [Supported Coding Agents](https://www.vibekanban.com/docs/supported-coding-agents)
48+
- ## Related Concepts
49+
- [[AI/Coding/Concept/Multi-Agent Orchestration]]
50+
- [[AI/Coding/Technique/Knowledge Base/Agentic]]
51+

‎pages/tmux___Cheat Sheet.md‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
tags:: [[Keyshorts]]
2+
3+
- # tmux Cheat Sheet
4+
- ## Prefix key
5+
- Default: `Ctrl+b`
6+
- ## Session management
7+
- | Command | Action |
8+
|-----------------------------|------------------------------------------|
9+
| `tmux` | Start a new session |
10+
| `tmux new -s <name>` | Start a new session with name |
11+
| `tmux ls` | List all sessions |
12+
| `tmux attach` / `tmux a` | Attach to the most recent session |
13+
| `tmux attach -t <name>` | Attach to a specific session |
14+
| `tmux kill-session -t <name>`| Terminate a specific session |
15+
| `tmux kill-session -a` | Kill all sessions except current |
16+
| `tmux kill-server` | Terminate all sessions and the server |
17+
- ## Window management (within a session)
18+
- default prefix is `ctrl+b`
19+
- | Shortcut (after prefix) | Action |
20+
|-----------------------------|------------------------------------------|
21+
| `c` | Create a new window |
22+
| `,` | Rename current window |
23+
| `&` | Kill current window |
24+
| `n` | Next window |
25+
| `p` | Previous window |
26+
| `w` | List windows |
27+
| `0..9` | Select window by number |
28+
| `$` | Rename session (interactive) |
29+
- ## Pane management
30+
- | Shortcut (after prefix) | Action |
31+
|-----------------------------|------------------------------------------|
32+
| `%` | Split pane **vertically** |
33+
| `"` | Split pane **horizontally** |
34+
| `x` | Kill current pane |
35+
| `o` | Switch to next pane |
36+
| `;` | Toggle last active pane |
37+
| `{` / `}` | Move pane left / right |
38+
| `z` | Toggle zoom/focus on current pane |
39+
| `<Arrow keys>` (with prefix+Ctrl) | Resize pane in direction |
40+
- ## Copy mode & scrolling
41+
- ==NOTE - tmux intercepts mouse wheel by default==
42+
- if you need to pass mouse wheel through to an application like [[Claude Code]], use one of these two:
43+
- 1 - config approach
44+
- add to `~/.tmux.conf`
45+
- ```tmux
46+
set -g mouse on
47+
```
48+
- reload conf:
49+
- `Ctrl-b : source-file ~/.tmux.conf`
50+
- 2 - immediate application
51+
- `ctrl-b : set -g mouse on`
52+
-
53+
- | Shortcut | Action |
54+
|-----------------------------|------------------------------------------|
55+
| `[` | Enter copy mode |
56+
| `]` | Paste buffer |
57+
| `Space` (in copy mode) | Begin text selection |
58+
| `Enter` (in copy mode) | Copy selection |
59+
| `q` | Exit copy mode |
60+
| Movement in copy mode | `h/j/k/l`, `w`, `b`, `PgUp/PgDn` etc. |
61+
- ## Configuration (via `~/.tmux.conf`)
62+
- Change prefix key: `unbind C-b` then `set-option -g prefix C-a`
63+
- [[tmux/setw]] - note, you have to enter the prefix and then colon before entering these commands, e.g. `ctrl+b :` then type the words
64+
- Rename windows by default: `set-option -g base-index 1` / `setw -g pane-base-index 1`
65+
- Enable vi-keys in copy mode: `setw -g mode-keys vi`
66+
- Enable mouse support: `setw -g mouse on`
67+
- ## Quick reference terms
68+
- **Session**: A container of windows.
69+
- **Window**: Like a tab; contains one or more panes.
70+
- **Pane**: A split region within a window (runs a shell/program).
71+
- **Client**: A terminal attached to a session.
72+
- **Server**: Background process managing sessions.

‎pages/tmux___Tutorial___Kanban for Agentic Coding.md‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# tmux as a Kanban for Agentic Coding (Minimal Tutorial)
2+
- ## Goal
3+
Use tmux window/pane titles as live "cards" that reflect issue + agent status (e.g., `#342 auth-bug [working]`, `#517 deps [PR]`).
4+
- ## 1) Absolute minimum tmux concepts
5+
- **Session** = workspace
6+
- **Window** = a card (one issue)
7+
- **Pane** = subprocess in a card (Claude, tests, logs, etc.)
8+
- **Prefix** = `Ctrl-b` (default)
9+
- ## 2) Commands you actually need
10+
- ### Create a card (window)
11+
- Prefix `c` → new window
12+
- ### Rename a card (set issue + status)
13+
- Prefix `,` → rename window interactively
14+
- ### Jump between cards
15+
- Prefix `w` → list windows
16+
- Prefix `0..9` → jump by index
17+
- ### Close a card when merged
18+
- Prefix `&` → kill window
19+
- ## 3) Make titles automatic (one-time config)
20+
Add to `~/.tmux.conf`:
21+
- ~~~
22+
# Allow programs to rename panes/windows
23+
set -g allow-rename on
24+
25+
# Prefer window name set by tmux when available
26+
set -g automatic-rename off
27+
28+
# Show window name in status bar
29+
set -g set-titles on
30+
set -g set-titles-string "#S:#W"
31+
~~~
32+
Reload config inside tmux:
33+
- ~~~
34+
tmux source-file ~/.tmux.conf
35+
~~~
36+
- ## 4) Update status from inside the terminal (no tmux commands needed)
37+
From **any shell** in a pane, change the *window name* (card title):
38+
- ~~~
39+
tmux rename-window "#342 auth-bug [working]"
40+
~~~
41+
Change just the **pane title** (useful if you split panes later):
42+
- ~~~
43+
printf '\033]2;%s\007' "Claude: planning"
44+
~~~
45+
- ## 5) Minimal workflow pattern
46+
- Prefix `c` → new window
47+
- `tmux rename-window "#NNN short-title [todo]"`
48+
- Start Claude Code in that window
49+
- As it progresses:
50+
- ~~~
51+
tmux rename-window "#NNN short-title [working]"
52+
tmux rename-window "#NNN short-title [PR]"
53+
tmux rename-window "#NNN short-title [merged]"
54+
~~~
55+
- Prefix `&` → close when done
56+
- You now have a tmux-based Kanban.
57+
- ## 6) Optional: tiny helpers (quality of life)
58+
Put in your shell rc (`.bashrc` / `.zshrc` / `.fish`):
59+
- ~~~
60+
issue() {
61+
tmux rename-window "$1"
62+
}
63+
64+
status() {
65+
local cur="$(tmux display-message -p '#W')"
66+
tmux rename-window "${cur%%[*}[$1]"
67+
}
68+
~~~
69+
Usage:
70+
- ~~~
71+
issue "#342 auth-bug [todo]"
72+
status working
73+
status PR
74+
status merged
75+
~~~
76+
- ## 7) Mental model
77+
- **Window name = card title + state**
78+
- **Kill window = close card**
79+
- **Window list = Kanban board**
80+
- That's it. Nothing else required.

‎pages/tmux___setw.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
1-
- Yes — **`setw` is only meaningful inside a tmux context.**
1+
- # About tmux setw
2+
- **`setw` is only meaningful inside a tmux context.**
23
- But there are *two different ways* it can be valid, depending on how you run it.
34
- ## 1. `setw` is a tmux command, not a shell command
45
`setw` is short for:
@@ -65,4 +66,4 @@
6566
- ## 6. Practical advice
6667
If you're experimenting:
6768
- Inside tmux live: → `prefix :` then type `setw ...`
68-
- Writing config or scripts: → use `tmux setw ...`
69+
- Writing config or scripts: → use `tmux setw ...`

0 commit comments

Comments
 (0)