CodeAlta is a terminal workspace for agentic coding. It brings model-provider setup, project navigation, prompt attachments, durable sessions, delegated work, and trusted local plugins behind the alta command.
CodeAlta is pre-release software. Configuration, screenshots, and extension APIs may change before
1.0.
Install .NET 10, then install the CodeAlta global tool:
dotnet tool install -g CodeAlta
altaUpdate an existing installation with:
dotnet tool update -g CodeAltaOn first launch, CodeAlta creates ~/.alta/config.toml. Existing config files are left untouched on later launches so you can remove, rename, or customize bundled entries. If no provider is enabled yet, the Model Providers dialog opens so you can configure Codex, Copilot, xAI Grok, OpenAI/Azure OpenAI/Alibaba APIs, Anthropic, Gemini/Vertex, or custom endpoints.
CodeAlta also expects a current Nerd Fonts patched font in your terminal profile. If icons or tree glyphs look wrong, update to the latest Nerd Fonts release, remove stale older font copies, and select the refreshed Nerd Font family, such as CaskaydiaCove Nerd Font.
- Keyboard-first terminal workspace: tabs, prompt editor, project sidebar, command discovery, model selectors, context status, and inspectable timeline cards stay in one TUI.
- Provider-neutral model setup: configure hosted APIs, subscription-backed Codex/Copilot/xAI Grok, cloud providers, and compatible endpoints with the same provider workflow.
- Context-aware prompts: select reusable agent prompt profiles, edit global/project prompt and system-prompt overrides, attach files and folders with
@, search GitHub issues with#in GitHub repositories, paste images when the selected model supports them, and inspect what context was sent. - Durable agent sessions: keep project-scoped history in CodeAlta-owned journals, reopen sessions independently of provider startup, queue prompts on busy sessions, steer running work where supported, and compact long agent-runtime conversations.
- Actionable operations: model/provider tests, startup config recovery, usage details, logs, modified-file summaries, and tool input/output dialogs are built into the workspace.
- Trusted local extension points: source plugins, Agent Skills-compatible skill folders, and the in-session
altalive tool let you automate local workflows while keeping provenance visible.
| Action | Shortcut / command |
|---|---|
| Help and command discovery | F1, /help, or ? |
| Open project | Ctrl+O or /open |
| Attach project files | type @ in the prompt |
| Manage prompts | Ctrl+G Ctrl+H or /prompt |
| Switch to next agent prompt | Ctrl+T or /next_prompt |
| Open model providers | Ctrl+G Ctrl+R or /model_providers |
| Refresh model providers | /model_providers_refresh |
| Browse models | Ctrl+G Ctrl+O or /models |
| Open logs | Ctrl+G Ctrl+L or /logs |
| Toggle navigator | Ctrl+G Ctrl+G |
| Switch tabs | Ctrl+Alt+Left / Ctrl+Alt+Right |
| Focus sidebar / prompt | Ctrl+G Ctrl+S / Ctrl+G Ctrl+P |
- User guide and screenshots: https://codealta.github.io/
- Getting started: https://codealta.github.io/docs/getting-started/
- Model provider configuration: https://codealta.github.io/docs/model-providers/
- Prompts and instructions: https://codealta.github.io/docs/prompts/
- In-session
altalive tool: doc/live-tool.md - Skills: doc/skills.md
- Maintainer notes: doc/readme.md
CodeAlta is released under the BSD-2-Clause license.
Alexandre Mutel aka xoofx.