# Authsia CLI

Bring Authsia to your terminal. Install, wire a workspace, connect an MCP client, guard a terminal, approve agents, then audit. Commands stay short; each guide carries the rules.

## Use cases

- [Keep plaintext out of repos](/docs/cli/workspace): Initialize commit-safe authsia:// refs and resolve them in the child process.

- [Connect local coding agents](/docs/cli/mcp): Six fixed MCP tools and no secret-return path. The client launches Authsia.

- [Manage and protect local MCP](/docs/cli/mcp-proxy): Use the local portal for existing STDIO protection and authenticated localhost Streamable HTTP.

- [Approve scoped agent access](/docs/cli/agent-jit): Folder, capability, and TTL — then revoke from Access Center or a paired iPhone.

## Quickstart

If you are installing Authsia for the first time, [start here](/docs/get-started).

quick path

```
# install app + CLI
brew install --cask james-liang-cs/authsia/authsia

# prepare the repo
authsia workspace init
authsia workspace status
authsia agent init --agent codex

# run commands through Authsia
authsia workspace run -- npm test
authsia mcp configure --client codex
authsia guard
```

## Guides

### Workspace and terminal

- [Install and check readiness](/docs/cli/install)

- [Workspace workflow](/docs/cli/workspace) — init, env select, run, resolution order

- [Guarded terminal](/docs/cli/guarded-terminal) — PATH shims; agents leave the boundary at launch

### Agents and MCP

- `authsia agent init --agent codex` — install project rules plus command-attribution and sub-agent-lineage hooks; review them in Codex `/hooks`

- [Local MCP server](/docs/cli/mcp) — configure and serve Authsia’s six tools

- [MCP Manager](/docs/cli/mcp-proxy) — portal, STDIO coverage, and localhost Streamable HTTP

- [Agent JIT approvals](/docs/cli/agent-jit) — scope, cleanup, automation credentials

### SSH and audit

- [SSH signing](/docs/cli/ssh)

- [Audit and recovery](/docs/cli/audit)

## Reference

- [Compact command map](/docs/cli/reference). Local `authsia --help` remains the option source of truth.

## Related topics

- [Developer quickstart](/docs/get-started)

- [Use the app](/user-guide.html)

- [Security model](/security.html)

- [AI-readable docs](/docs/ai-readable-docs)