git-coco 0.57.0 → 0.58.0

package/README.md

@@ -37,7 +37,7 @@ coco init
 
 # Generate your first commit
 git add .
-coco -i
+coco commit -i
 ```
 
 ## Commands
@@ -50,6 +50,8 @@ coco -i
 - **`coco ui`** - Open the full-screen Git workstation TUI
 - **`coco init`** - Interactive setup wizard
 
+> **Smart default (0.57.0+):** running `coco` with **no subcommand** routes by environment — `coco ui` inside a git repo, `coco workspace` outside one, or `coco init` on a fresh install. It no longer defaults to `commit`; use `coco commit` for messages (or `--commit` / `COCO_DEFAULT=commit` to restore the old default).
+
 ## Usage Examples
 
 ### Basic Workflow
@@ -59,23 +61,23 @@ coco -i
 git add .
 
 # Generate commit message (interactive mode recommended)
-coco -i
+coco commit -i
 
 # Or use stdout mode
-git commit -m "$(coco)"
+git commit -m "$(coco commit)"
 ```
 
 ### Conventional Commits
 
 ```bash
 # Enable conventional commits format
-coco --conventional
+coco commit --conventional
 
 # With additional context
-coco -a "Fixes login timeout" --conventional
+coco commit -a "Fixes login timeout" --conventional
 
 # Include ticket from branch name
-coco --append-ticket --conventional
+coco commit --append-ticket --conventional
 ```
 
 ### Team Workflows

package/dist/index.d.ts

@@ -363,10 +363,13 @@ type BaseConfig = {
     workspace?: {
         /**
          * Directories to scan for git repositories. Each entry may use a
-         * `~` prefix; resolved against the user's home directory. Defaults
-         * to `['~/code']` when omitted.
+         * `~` prefix; resolved against the user's home directory. When
+         * omitted (and no `--root` flag is passed), the workspace scans the
+         * current working directory — so a bare `coco` / `coco ws` discovers
+         * repos wherever you launched it. Set this to pin a fixed tree (e.g.
+         * `["~/code"]`) regardless of where you run from.
          *
-         * @default ['~/code']
+         * (No static `@default` — the effective default is the runtime cwd.)
          */
         roots?: string[];
         /**