cosh-ng User Guide
cosh-ng is an AI-native Linux terminal that keeps normal Shell work and Agent tasks together. Start with the quick start, then use the task-based links below for the feature or command you need.
Start here
- Quick start — install cosh-ng and run a first task.
- Model providers — configure authentication and select a provider.
- Configuration — review files, settings, and precedence.
- Supported platforms — check package and service backends.
Work in the terminal
| Goal | Read next |
|---|---|
| Run Shell commands and natural-language tasks together | Interactive terminal |
| Choose when Agent tool calls require confirmation | Tool approval |
| Resume or compact a conversation | Session recovery |
| Learn slash commands and keyboard behavior | Interactive behavior |
Add capabilities
| Goal | Read next |
|---|---|
| Share instructions across a project or team | Skills |
| Connect tools from a local process or remote service | Connect an MCP server |
| Bundle Skills, Hooks, settings, and tools | Extensions |
| Run checks around Agent lifecycle events | Hooks |
Manage system operations
Use read-only commands first. Add --dry-run to a supported package or service mutation before making a change; these operations usually need root privileges.
| Goal | Read next |
|---|---|
| Find, install, or remove packages | Package management |
| Inspect or change systemd services | Service management |
| Save, compare, restore, or clean workspace snapshots | Workspace checkpoints |
| Check policy decisions and audit events | Security audit |
Integrate and automate
- Structured OS CLI — command domains and safe automation patterns.
- Output format — the
CoshResponse<T>success and error envelope. - Headless mode — JSONL integration for other frontends.
- Agent tools — tool boundaries and approval behavior.