AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing danshapiro/freshell in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Overview (README excerpt)
Crawler view🐚🔥freshell Claudes Code, Codex, shells, and editors in joyful harmony. Speak with the dead, jump to your phone, and more. CLIs in tabs and panes | Forever coding agent history | What if tmux and Claude fell in love? --- Features • **Tabs and panes** — Organize projects with multiple coding agents, shells, browsers, editors, and more on a tab - and as many tabs as you want. • **Desktop, laptop, phone** — Run on your main machine, then work on your project anywhere via VPN or Tailscale. • **Speak with the dead** — Resume any Claude, Codex, or OpenCode session from any device (even if you weren't using freshell to run it) • **Fancy tabs** — Auto-name from terminal content, drag-and-drop reorder, and per-pane type icons so you know what's in each tab • **Freshclaude** — An interactive alternative to Claude CLI that works with your Anthropic subscription. • **Self-configuring workspace** — Just ask Claude or Codex to open a browser in a pane, or create a tab with four subagents. Built-in tmux-like API and skill makes it simple. • **Live pane headers** — See your active directory, git branch, and context usage in every pane title bar, updating live as you work • **Activity notifications** — Configurable attention indicators (highlight, pulse, darken) on tabs and pane headers when a coding CLI finishes its turn, with click or type dismiss modes • **Mobile responsive** — Auto-collapsing sidebar and overlay navigation for phones and tablets Quick Start On first run, freshell auto-generates a file with a secure random . The token is printed to the console at startup — open the URL shown to connect. Prerequisites Node.js 18+ (20+ recommended) and platform build tools for native modules ( on Windows, Xcode CLI Tools on macOS, on Linux). > **Note:** On native Windows, terminals default to WSL. Set or to use a native Windows shell instead. Usage Visible-First Audit The audit writes one JSON artifact to by default. It captures one desktop sample and one bandwidth-restricted mobile sample per scenario so the later visible-first transport work can be compared against the same workload with a single machine-readable file. Keyboard Shortcuts | Shortcut | Action | |----------|--------| | | New tab | | | Close tab | | | Previous tab | | | Next tab | | | Move tab left | | | Move tab right | | | Copy selection (in terminal) | | / | Paste (in terminal) | | | Search (in terminal) | | | Newline (in terminal) | | | Scroll to bottom (in terminal) | | / | Context menu | Configuration Environment Variables | Variable | Required | Description | |----------|----------|-------------| | | Auto | Authentication token (auto-generated on first run, min 16 chars) | | | No | Server port (default: 3001) | | | No | Comma-separated allowed CORS origins (auto-detected from LAN) | | | No | Path to Claude config directory (default: ) | | | No | Path to Codex config directory (default: ) | | | No | Windows shell: (default), , or | | | No | WSL distribution name (Windows only) | | | No | Claude CLI command override | | | No | Codex CLI command override | | | No | OpenCode CLI command override | | | No | Gemini CLI command override | | | No | Kimi CLI command override | | | No | Gemini API key for AI-powered terminal summaries | Coding CLI Providers Freshell indexes local session history and can launch terminals for these coding CLIs: | Provider | Session history | Launch terminals | Home directory | |----------|:-:|:-:|----------------| | **Claude Code** | Yes | Yes | | | **Codex** | Yes | Yes | | | **OpenCode** | Yes | Yes | (or platform default) | | **Gemini** | — | Yes | — | | **Kimi** | — | Yes | — | Enable/disable providers and set defaults in the Settings UI or via . OpenCode sessions are discovered directly from OpenCode's local session database, so existing OpenCode work can be resumed from freshell without importing anything manually. Tech Stack • **Frontend**: React 18, Redux Toolkit, Tailwind CSS, xterm.js, Monaco Editor, Zod, lucide-react • **Backend**: Express, WebSocket (ws), node-pty, Pino, Chokidar, Zod • **Build**: Vite, TypeScript • **Testing**: Vitest, Testing Library, supertest, superwstest • **AI**: Vercel AI SDK with Google Gemini Extensions Freshell supports custom pane types via extensions. Three categories are available: • **Client** — Static HTML/JS served by freshell (no server needed) • **Server** — Your own HTTP server, managed by freshell with automatic port allocation • **CLI** — Any terminal tool wrapped as a pane Drop a directory with a manifest into and restart freshell. See for working examples of each type. Contributing Contributions are welcome! Please feel free to submit a Pull Request. Community Projects Projects built by the community around freshell. • freshell-container — Docker container packaging freshell with all supported coding CLI providers for self-hosted, multi-device access License MIT License — see LICENSE for details. --- Made with terminals and caffeine