multica/docs/cli.md
2026-02-17 00:53:37 +08:00

129 lines
2.1 KiB
Markdown

# CLI Guide (`multica`)
## Entry
```bash
pnpm multica
```
Equivalent command names:
- `multica`
- `mu`
## Core Commands
```bash
multica # interactive chat (default)
multica run "<prompt>" # one-shot run
multica chat # explicit interactive mode
multica session <command> # session management
multica profile <command> # profile management
multica skills <command> # skill management
multica tools <command> # tool policy inspection
multica credentials <command> # credentials management
multica cron <command> # scheduled tasks
multica dev [service] # start dev services
multica help
```
## Run Mode
```bash
multica run [options] <prompt>
echo "prompt" | multica run
```
Common options:
- `--profile <id>`
- `--provider <name>`
- `--model <name>`
- `--session <id>`
- `--cwd <dir>`
- `--run-log`
- `--tools-allow a,b,c`
- `--tools-deny a,b,c`
- `--context-window <tokens>`
## Chat Mode
```bash
multica chat [options]
multica [options]
```
In-chat commands:
- `/help`
- `/exit`
- `/clear`
- `/session`
- `/new`
- `/multiline`
- `/provider`
- `/model`
## Sessions
```bash
multica session list
multica session show <id>
multica session delete <id>
```
Session data root:
- `~/.super-multica/sessions/`
- or `SMC_DATA_DIR/sessions/`
## Profiles
```bash
multica profile list
multica profile new <id>
multica profile setup <id>
multica profile show <id>
multica profile edit <id>
multica profile delete <id>
```
## Skills
```bash
multica skills list
multica skills status [id]
multica skills install <id>
multica skills add <owner/repo[/skill]>
multica skills remove <name>
```
## Tools
```bash
multica tools list
multica tools list --allow group:fs,web_fetch
multica tools list --deny exec
multica tools groups
```
## Credentials
```bash
multica credentials init
multica credentials show
multica credentials edit
```
## Cron
```bash
multica cron status
multica cron list
multica cron add -n "name" --every "30m" --message "..."
multica cron run <id>
multica cron enable <id>
multica cron disable <id>
multica cron remove <id>
multica cron logs <id>
```