obra/freshell
The Agentic IDE (or, the loving child of tmux and claude code)
https://skillcdn.ai/gh/obra/freshell내 AI에 이 주소를 연결하면 이 스킬들을 쓸 수 있어요. 연결 방법 보기
- 미확인
- 기본 브랜치
main - 커밋
05c6b1f - 라이선스
선언되지 않음
저장소 둘러보기
스킬과 문서의 원문에서 찾습니다. 화면용 번역은 검색되지 않아요.
문서
- Claude Code Session Organizer - Implementation PlanGoal: Build a browser-based web app for managing multiple Claude Code sessions in a tabbed interface with terminal embedding, session history, and AI-powered summaries. Accessible remotely from phone…docs/plans/2026-01-26-implementation-plan.md
- Claude Chat UI Refactor Implementation PlanGoal: Replace terminal-based Claude rendering with a chat-style React UI that parses Claude Code's stream-json output, providing native scrollback, no flashing, and better UX.docs/plans/2026-01-28-claude-chat-ui-refactor.md
- Comprehensive Test Coverage Implementation PlanGoal: Achieve comprehensive test coverage across unit, integration, and E2E tests for the Claude Code Session Organizer application.docs/plans/2026-01-28-comprehensive-test-coverage.md
- Replace CSS Zoom with Rem-Based UI ScalingGoal: Replace non-standard CSS zoom with standards-compliant rem-based font scaling to fix xterm.js mouse coordinate issues while preserving UI scaling functionality.docs/plans/2026-01-28-rem-based-ui-scaling.md
- Session-Centric Sidebar Implementation PlanGoal: Replace terminal-centric sidebar with session-centric view where sessions show a play icon when running in a terminal.docs/plans/2026-01-28-session-centric-sidebar.md
- Auto-Update Implementation PlanGoal: On launch, check GitHub for new releases and offer "There's a new Freshell waiting for you!" prompt with yes/no upgrade.docs/plans/2026-01-29-auto-update.md
- Claude Session Auto-Association Implementation PlanGoal: When Claude creates a new session, automatically associate it with the running terminal so it can be resumed after server restart.docs/plans/2026-01-29-claude-session-auto-association.md
- Drag-and-Drop Tab Reordering DesignAdd drag-and-drop reordering to the top tab bar, allowing users to rearrange terminal tabs by dragging them to new positions.docs/plans/2026-01-29-drag-drop-tabs-design.md
- Drag-and-Drop Tab Reordering Implementation PlanGoal: Enable users to reorder tabs by dragging them to new positions, with keyboard accessibility and touch support.docs/plans/2026-01-29-drag-drop-tabs-impl.md
- Tab Naming and Terminal Association - Complete FixInvestigation of tab naming bugs revealed two concrete bugs and one misfeature (cwd-based auto-titling). The sidebar architecture is already session-centric - sessions from ~/.claude are the source o…docs/plans/2026-01-29-fix-tab-naming-terminal-association.md
- Fix Terminal Resize on Tab Switch Implementation PlanGoal: Fix terminal width being incorrectly set when switching tabs, by propagating the hidden prop through the component hierarchy so TerminalView knows when it becomes visible.docs/plans/2026-01-29-fix-terminal-resize-on-tab-switch.md
- Monaco Editor Pane DesignAdd a Monaco-based editor pane type to Freshell, alongside existing terminal and browser panes. The editor supports file editing, scratch pads, and read-only viewing with special handling for markdow…docs/plans/2026-01-29-monaco-editor-pane-design.md
- Monaco Editor Pane Implementation PlanGoal: Add a Monaco-based editor pane type alongside terminal and browser panes, with file editing, scratch pads, markdown/HTML preview, and auto-save.docs/plans/2026-01-29-monaco-editor-pane-impl.md
- Multi-CLI Architecture SpecificationThis specification defines a modular, extensible architecture for supporting multiple coding CLIs in Freshell. Based on exhaustive research of Claude Code, Codex CLI, OpenCode, Gemini CLI, and Kimi C…docs/plans/2026-01-29-multi-cli-architecture-spec.md
- Multi-CLI Support Plan: Adding Codex and Future Coding CLIsThis document outlines the plan to generalize Freshell's Claude Code integration to support multiple coding CLIs, starting with OpenAI Codex and designed for future expansion to OpenCode, Kimi CLI, a…docs/plans/2026-01-29-multi-cli-support.md
- Pane-First Terminal Ownership Implementation PlanGoal: Move terminal lifecycle ownership from tabs to panes so that splitting creates independent terminals.docs/plans/2026-01-29-pane-first-terminal-ownership.md
- Split Panes with FAB Implementation PlanGoal: Add a FAB (Floating Action Button) that allows splitting terminal tabs into multiple resizable panes containing terminals or browsers.docs/plans/2026-01-29-split-panes-fab.md
- Pane Picker DesignReplace the current "new pane opens as shell immediately" behavior with a picker UI. When a new pane appears (via new tab or FAB), the user sees centered icons for each pane type and clicks to choose…docs/plans/2026-01-30-pane-picker-design.md
- Pane Picker Implementation PlanGoal: Replace immediate shell creation with a picker UI that lets users choose pane type (shell, browser, editor).docs/plans/2026-01-30-pane-picker-implementation.md
- Rollback Monaco Squash and Proper MergeGoal: Roll back the broken monaco squash (de47990), restore main to the good state (f25a6a2), and properly merge the monaco feature.docs/plans/2026-01-30-rollback-monaco-squash.md
- Claude Session Auto-Repair DesignAfter Freshell crashes, Claude sessions fail to resume - users see "Sautéed for X time" but no conversation history. All session data appears lost.docs/plans/2026-01-30-session-repair-design.md
- Deterministic Claude Session Restore Implementation PlanGoal: Ensure Claude terminal panes resume deterministically using only known, valid session IDs discovered from Claude sessions, while keeping legacy paths and session repair aligned.docs/plans/2026-01-31-deterministic-claude-session-restore.md
- Session Search Implementation PlanGoal: Add tiered search to Claude sessions - title-only, user messages, and full text search.docs/plans/2026-01-31-session-search.md
- Oracle Review: Right Click Context Menus PlanReviewed by: GPT-5.2 Pro Date: 2026-02-01 Duration: 13m00sdocs/plans/2026-02-01-right-click-context-menus-oracle-review.md
- Right Click Context Menus Implementation PlanGoal: Add a unified right-click (and long-press) context menu system across the Freshell UI, including session archive and metadata actions.docs/plans/2026-02-01-right-click-context-menus.md
- Session createdAt derivation (read-only)Use session JSONL timestamps as the source of truth for createdAt and stop persisting auto-generated createdAt overrides to user config. Keep config writes strictly for user intent (manual overrides).docs/plans/2026-02-01-session-createdAt-derivation-design.md
- Coding CLI Indexer Scaling Design (50k sessions)Scale the Coding CLI session indexer to handle up to ~50,000 sessions without blocking the event loop. The current indexer fully rescans all session files on any refresh and the search endpoint reads…docs/plans/2026-02-02-coding-cli-indexer-scaling-design.md
- Debug Logging to Disk (Perf as Debug Only)Date: 2026-02-02 Status: Approveddocs/plans/2026-02-02-debug-logging-to-disk-design.md
- WSL2 LAN Access - DesignWhen Freshell runs inside WSL2, the share button correctly detects the Windows host's LAN IP (e.g., 192.168.3.50), but external devices can't actually connect because WSL2 uses NAT networking. The se…docs/plans/2026-02-03-wsl2-lan-access-design.md
- WSL2 LAN Access Implementation PlanGoal: Automatically configure Windows port forwarding when running in WSL2 so external LAN devices can reach Freshell.docs/plans/2026-02-03-wsl2-lan-access.md
- Pane Picker: Coding CLI ButtonsGoal: Add Claude and Codex as first-class options in the pane picker, with per-CLI starting directory settings and server-side CLI availability detection.docs/plans/2026-02-05-pane-picker-coding-clis.md
- Behavior Correctness And Robustness Implementation PlanGoal: Fix user-facing correctness mismatches in terminal lifecycle, WebSocket handshake/reattach semantics, defaults/persistence, and noisy logging so Freshell behaves the way users expect under load…docs/plans/2026-02-06-behavior-correctness.md
- Directory Picker for Coding CLI LaunchWhen launching a coding CLI (Claude, Codex, etc.) from the pane picker, it either uses a saved per-provider cwd from settings or the system default. There's no quick way to choose a directory at laun…docs/plans/2026-02-06-directory-picker.md
- Sessions Delta Sync Implementation PlanStatus: COMPLETE — All tasks implemented across multiple branches, now merged to main. The delta sync system is fully operational: sessions.patch messages, capability negotiation, client reducers, co…docs/plans/2026-02-07-sessions-delta-sync.md
- Codex + Claude Turn-Complete Bell and Tab Attention Implementation PlanGoal: Play a short bell and highlight the owning tab (light green) when a Codex/Claude turn completes, unless the window is focused and that tab is already active.docs/plans/2026-02-08-codex-claude-turn-complete-bell-tab-attention.md
- Session Save & Restore Consistency FixesGoal: Fix 7 bugs found via static analysis that cause sessions to not restore correctly after page reload, server restart, or cross-tab sync.docs/plans/2026-02-08-session-restore-consistency.md
- Terminal Paste Single-Ingress Pipeline Implementation PlanGoal: Eliminate double-paste and normalize paste behavior across browsers/OS by enforcing a single terminal input ingress path.docs/plans/2026-02-08-terminal-paste-single-ingress.md
- Plan: Improve Session Title Extraction & Worktree Project GroupingSteps 1–4 (title extraction quality) landed on main as c74b5ed. Only Step 5 (worktree project grouping) remains.docs/plans/2026-02-08-worktree-project-grouping.md
- Pane UX Overhaul Implementation PlanGoal: Transform pane management from a clunky, grid-rebuilding system into an intuitive, consumer-grade layout experience where panes open predictably, close gracefully, resize with smart snapping, a…docs/plans/2026-02-09-pane-ux-overhaul.md
- Pane Header Runtime Metadata (cwd/branch-dirty/token %) Implementation PlanGoal: For Codex and Claude terminal panes, render right-aligned runtime metadata in the pane title bar as:docs/plans/2026-02-10-pane-header-metadata-one-shot.md
- Freshell Full Rust Port (+ Optional Tauri Client) Implementation PlanGoal: Replace Freshell’s TypeScript/Node stack with a Rust backend and Rust/WASM frontend, and ship an optional Tauri desktop client with feature parity.docs/plans/2026-02-10-rust-port-freshell-tauri.md
- WS Attach Snapshot Chunking + Sessions Publish Coalescing Implementation PlanGoal: Remove attach-time websocket backpressure spikes and reduce session update storms without removing any existing behavior.docs/plans/2026-02-10-ws-attach-chunking-sessions-coalescing.md
- Claude Web Client Pane Implementation PlanGoal: Add a "Claude Code (Web)" pane type to Freshell that provides a rich chat-style UI for Claude Code sessions — markdown-rendered messages, visual permission approval, tool call visualization, an…docs/plans/2026-02-11-claude-web-client-pane.md
- Fix Attention Dismissal — ComprehensiveGoal: Fix all broken attention dismissal paths: clicking active tab, closing panes, closing tabs.docs/plans/2026-02-12-fix-attention-dismissal.md
- Fix Claude Pane Restoration After Server ResetGoal: Prevent Claude panes from losing conversation history when the Freshell server is reset.docs/plans/2026-02-12-fix-claude-pane-restoration.md
- Fix SDK Bridge Startup — Claude Web Pane Hangs at "Starting Claude Code..."Goal: Fix three issues preventing the Claude Web pane from connecting: the subprocess refusing to start due to inherited CLAUDECODE env var, silent error loss from a message ordering race, and missin…docs/plans/2026-02-12-fix-sdk-bridge-startup.md
- SDK Bridge Remediation PlanGoal: Replace freshell's broken hand-rolled SDK bridge with one built on the official @anthropic-ai/claude-agent-sdk TypeScript package, matching the approach proven in claudechic (the known-good ref…docs/plans/2026-02-12-sdk-bridge-remediation.md
- Freshclaude Client Improvements — DesignDate: 2026-02-13 Branch: claude-client-fixesdocs/plans/2026-02-13-freshclaude-design.md
- Freshclaude Client Improvements — Implementation PlanGoal: Rename Claude Web to freshclaude, add per-pane settings popover with model/permissions/display toggles, fix scroll preservation, fix permission status text, and add a new icon.docs/plans/2026-02-13-freshclaude-impl.md
- Freshclaude Polish: Claude Chic Parity Implementation PlanGoal: Bring freshclaude's chat UI up to Claude Chic's level of visual polish and information density through progressive disclosure, color-coded message types, smart tool headers, auto-collapse, stre…docs/plans/2026-02-13-freshclaude-polish.md