1. Home
  2. Docs

User Guide

CodeAlta is a terminal workspace for agentic coding. It brings together local project navigation, model-provider setup, prompt attachments, thread/session history, delegated work, and trusted plugins behind the alta command.

Start with the first two pages, then use the topic pages as a reference while you work.

CodeAlta home workspace showing the projects sidebar, active thread timeline, prompt editor, and provider footer
The main alta workspace keeps projects, threads, timeline entries, prompt drafting, provider state, and context usage in one terminal surface.

Start here

  1. Getting Started: install the tool, launch it, configure the first provider, and send a first prompt.
  2. Model Providers: understand the default config.toml, common provider types, credentials, models, reasoning settings, and provider testing.
  3. Workspace and Dialogs: learn the main terminal screen, timeline, prompt editor, file picker, logs, settings, and management dialogs.

Daily workflow topics

  • Threads and Delegation: global vs project threads, multiple-agent delegation, prompt queues, steering, compaction, and the in-session alta live tool.
  • CodeAlta Principles: the efficient, transparent, keyboard-first, thread-oriented, provider-agnostic, native .NET, error-aware, and pluggable design manifesto.
  • Plugins: trusted source plugins, plugin scopes, management UI, safe mode, and a minimal plugin example.
  • Troubleshooting: logs, broken configuration, plugin startup failures, login flows, and single-instance behavior.

What is intentionally not here

This website is end-user documentation. Internal architecture notes, implementation specs, and development plans live in the repository doc/ folder instead of the public site.