feat(cli): add takopi config subcommand (#153)

2026-01-16 11:28:06 +04:00
parent dec93019b1
commit 92b33c5181
25 changed files with 1248 additions and 246 deletions
@@ -4,9 +4,17 @@ Takopi reads configuration from `~/.takopi/takopi.toml`.

 If you expect to edit config while Takopi is running, set:

-```toml
-watch_config = true
-```
+=== "takopi config"
+
+    ```sh
+    takopi config set watch_config true
+    ```
+
+=== "toml"
+
+    ```toml
+    watch_config = true
+    ```

 ## Top-level keys

@@ -19,11 +27,20 @@ watch_config = true

 ## `transports.telegram`

-```toml
-[transports.telegram]
-bot_token = "..."
-chat_id = 123
-```
+=== "takopi config"
+
+    ```sh
+    takopi config set transports.telegram.bot_token "..."
+    takopi config set transports.telegram.chat_id 123
+    ```
+
+=== "toml"
+
+    ```toml
+    [transports.telegram]
+    bot_token = "..."
+    chat_id = 123
+    ```

 | Key | Type | Default | Notes |
 |-----|------|---------|-------|
@@ -62,14 +79,26 @@ File size limits (not configurable):

 ## `projects.<alias>`

-```toml
-[projects.happy-gadgets]
-path = "~/dev/happy-gadgets"
-worktrees_dir = ".worktrees"
-default_engine = "claude"
-worktree_base = "master"
-chat_id = -1001234567890
-```
+=== "takopi config"
+
+    ```sh
+    takopi config set projects.happy-gadgets.path "~/dev/happy-gadgets"
+    takopi config set projects.happy-gadgets.worktrees_dir ".worktrees"
+    takopi config set projects.happy-gadgets.default_engine "claude"
+    takopi config set projects.happy-gadgets.worktree_base "master"
+    takopi config set projects.happy-gadgets.chat_id -1001234567890
+    ```
+
+=== "toml"
+
+    ```toml
+    [projects.happy-gadgets]
+    path = "~/dev/happy-gadgets"
+    worktrees_dir = ".worktrees"
+    default_engine = "claude"
+    worktree_base = "master"
+    chat_id = -1001234567890
+    ```

 | Key | Type | Default | Notes |
 |-----|------|---------|-------|
@@ -85,10 +114,18 @@ Legacy config note: top-level `bot_token` / `chat_id` are auto-migrated into `[t

 ### `plugins.enabled`

-```toml
-[plugins]
-enabled = ["takopi-transport-slack", "takopi-engine-acme"]
-```
+=== "takopi config"
+
+    ```sh
+    takopi config set plugins.enabled '["takopi-transport-slack", "takopi-engine-acme"]'
+    ```
+
+=== "toml"
+
+    ```toml
+    [plugins]
+    enabled = ["takopi-transport-slack", "takopi-engine-acme"]
+    ```

 - `enabled = []` (default) means “load all installed plugins”.
 - If non-empty, only distributions with matching names are visible (case-insensitive).
@@ -99,11 +136,99 @@ Plugin-specific configuration lives under `[plugins.<id>]` and is passed to comm

 ## Engine-specific config tables

-Engines can have top-level config tables keyed by engine id, for example:
+Engines use **top-level tables** keyed by engine id. Built-in engines are listed
+here; plugin engines should document their own keys.

-```toml
-[codex]
-model = "..."
-```
+### `codex`

-The shape is engine-defined.
+| Key | Type | Default | Notes |
+|-----|------|---------|-------|
+| `extra_args` | string[] | `["-c", "notify=[]"]` | Extra CLI args for `codex` (exec-only flags are rejected). |
+| `profile` | string | (unset) | Passed as `--profile <name>` and used as the session title. |
+
+=== "takopi config"
+
+    ```sh
+    takopi config set codex.extra_args '["-c", "notify=[]"]'
+    takopi config set codex.profile "work"
+    ```
+
+=== "toml"
+
+    ```toml
+    [codex]
+    extra_args = ["-c", "notify=[]"]
+    profile = "work"
+    ```
+
+### `claude`
+
+| Key | Type | Default | Notes |
+|-----|------|---------|-------|
+| `model` | string | (unset) | Optional model override. |
+| `allowed_tools` | string[] | `["Bash", "Read", "Edit", "Write"]` | Auto-approve tool rules. |
+| `dangerously_skip_permissions` | bool | `false` | Skip Claude permissions prompts. |
+| `use_api_billing` | bool | `false` | Keep `ANTHROPIC_API_KEY` for API billing. |
+
+=== "takopi config"
+
+    ```sh
+    takopi config set claude.model "claude-sonnet-4-5-20250929"
+    takopi config set claude.allowed_tools '["Bash", "Read", "Edit", "Write"]'
+    takopi config set claude.dangerously_skip_permissions false
+    takopi config set claude.use_api_billing false
+    ```
+
+=== "toml"
+
+    ```toml
+    [claude]
+    model = "claude-sonnet-4-5-20250929"
+    allowed_tools = ["Bash", "Read", "Edit", "Write"]
+    dangerously_skip_permissions = false
+    use_api_billing = false
+    ```
+
+### `pi`
+
+| Key | Type | Default | Notes |
+|-----|------|---------|-------|
+| `model` | string | (unset) | Passed as `--model`. |
+| `provider` | string | (unset) | Passed as `--provider`. |
+| `extra_args` | string[] | `[]` | Extra CLI args for `pi`. |
+
+=== "takopi config"
+
+    ```sh
+    takopi config set pi.model "..."
+    takopi config set pi.provider "..."
+    takopi config set pi.extra_args "[]"
+    ```
+
+=== "toml"
+
+    ```toml
+    [pi]
+    model = "..."
+    provider = "..."
+    extra_args = []
+    ```
+
+### `opencode`
+
+| Key | Type | Default | Notes |
+|-----|------|---------|-------|
+| `model` | string | (unset) | Optional model override. |
+
+=== "takopi config"
+
+    ```sh
+    takopi config set opencode.model "claude-sonnet"
+    ```
+
+=== "toml"
+
+    ```toml
+    [opencode]
+    model = "claude-sonnet"
+    ```