CodeAlta.Tui.win-arm64

CodeAlta

CodeAlta is an open-source workspace for AI coding agents, local code, terminals and Git. It runs on Windows, macOS and Linux, with a desktop app and a terminal UI.

No telemetry: CodeAlta does not send usage analytics to its developers.

🚀 Install

Install .NET 10 (on macOS, 10.0.13 or later), then install CodeAlta Desktop, the app we recommend:

dotnet tool install -g CodeAlta
alta

CodeAlta TUI shares your profile, providers and sessions. Install both and continue your work in either:

dotnet tool install -g CodeAlta.Tui
altatui

Launch the app from a project folder. On first launch it opens the provider setup: sign in with a Claude, ChatGPT or GitHub Copilot subscription, or add an API key.

See Getting Started for requirements and the first steps.

✨ Features

CodeAlta Desktop brings together:

• Sessions & delegation: run agents in split panes; resume, queue, steer and delegate work; archive finished sessions and restore them when you need them. In Desktop, Enter sends when idle and enqueues while busy; Cmd+Enter on macOS or Ctrl+Enter on Windows/Linux sends now (steers a busy turn).
• Several windows: move or drag tabs into windows of their own, name and color them, and find them on their monitor at the next start (the terminal UI has one screen).
• Fork & rewind: branch a session from any turn and keep the original, or roll it back to an earlier prompt.
• Attach files: add files, images, folders and issues to a prompt from a menu, a drop or a paste; PDFs go to the models that read them, and other documents (Word, Excel, PowerPoint…) are converted to Markdown for any model.
• Speech to prompt: dictate a prompt with a speech model that runs on your computer, downloaded the first time you use the microphone.
• Search your work: Ctrl+P and alta search find the prompts and answers of your sessions, your plans, the guide, the skills and the tools from a local index; turn on search by meaning to find them by what they are about, with a model that runs on your computer.
• Code & Git: search and edit files, run terminals and inspect diffs.
• Worktrees: give sessions separate checkouts and branches; manage and clean them up.
• Session titles: a title you give stays; other sessions are titled from the first prompt, the last message or by the model, as you choose.
• Work items: review agent-proposed tasks and plans; start, defer or dismiss them; follow the reviews in flight.
• Reviews: comment on the lines of a plan, a file or an agent's changes, send them with a verdict, and have agents wait for your approval before they commit.
• Bookmarks: mark a message or a whole session, jump between the bookmarks of a timeline, and find them all in one tab.
• Issues & pull requests: browse issues and PRs on GitHub, GitLab, Azure DevOps or Bitbucket, plus Jira issues; start sessions and open PRs.
• Automations: start sessions on a schedule, issue/PR events or on demand.
• Canvases: use interactive boards, checklists and custom tools beside your conversations.
• Plugins: ask agents to build trusted local .NET canvases, dialogs, tools, commands and buttons for one project or the whole workspace.
• Local statistics: track activity, models, tokens, costs, tool use, skills and MCP tools by project, session or sub-agent, all on your computer.
• Context usage: see context pressure as a ring beside the prompt and when the prompt cache expires; inspect the last operation and session-wide token usage and costs.
• Spaces: give each kind of work its own setup: its projects and chats, providers and accounts (a second Claude account too), MCP servers, skills, agent prompts and plugins, and the Git, GitHub, Jira and command line (Azure, AWS, kubectl…) identity its agents use. Switch spaces while agents keep working.
• Welcome page: jump back to recent projects and sessions, with useful shortcuts.
• Built-in documentation: read the guide beside your work, or ask an agent to help.
• Model choice: use Claude Code, Codex or GitHub Copilot subscriptions, or APIs, with several accounts of the same provider; choose provider, model and reasoning effort per session.
• Model tiers & fallback: pick Complex, Standard or Quick instead of a model, and optionally go on with the next model of the tier when a provider runs out of quota or goes down.
• Claude Code with VS Code: continue in CodeAlta the Claude Code sessions you started in VS Code or a terminal, and open CodeAlta's in VS Code in one click.
• Permissions & visibility: set each session to ask first, accept edits or run freely, and turn off tools a session should not have, such as the shell; inspect tool inputs, outputs, file changes and live commands.
• Agent prompts: plan, build, review or define your own roles.
• Skills & MCP: bring in skills, tools and services; the skills used most come first in the prompt, and hundreds of them stay cheap.
• Copilot compatibility: reuse .github instructions, skills and agents unchanged.
• UI automation: let agents see and drive CodeAlta through built-in tools or MCP.
• Storage: manage local disk usage and cleanup.

📖 Documentation

Visit the website for the feature tour and user guide, including model providers and how Desktop and TUI compare.

For architecture and contributor guidance, see the developer documentation.

🪪 License

CodeAlta is released under the BSD-2-Clause license.

🤗 Author

Alexandre Mutel aka xoofx.