git-coco 0.33.0 → 0.35.0

package/README.md

@@ -10,7 +10,7 @@
 [![Last Commit](https://img.shields.io/github/last-commit/gfargo/coco)](https://github.com/gfargo/coco/tree/main)
 [![Discord](https://img.shields.io/discord/1176716060825767948)](https://discord.gg/KGu9nE9Ejx)
 
-An AI-powered git assistant that generates meaningful commit messages, creates changelogs, and streamlines your development workflow.
+An AI-powered git assistant that generates meaningful commit messages, creates changelogs, explores repository history, and streamlines your development workflow.
 
 **✨ Key Features:**
 
@@ -18,6 +18,7 @@ An AI-powered git assistant that generates meaningful commit messages, creates c
 - 📋 **Conventional Commits** - Full support with automatic validation and formatting  
 - 🔧 **Commitlint Integration** - Seamless integration with your existing commitlint configuration
 - 🏠 **Local AI Support** - Run completely offline with Ollama (no API costs, full privacy)
+- 🖥️ **Coco UI Git Workstation** - Seven top-level views (history, status, diff, compose, branches, tags, stash) reachable via `g`-prefixed chords, with an interactive command palette (`:`) and global search (`/`)
 - 📦 **Package Manager Friendly** - Works with npm, yarn, and pnpm
 - 👥 **Team Ready** - Shared configurations and enterprise deployment
 
@@ -45,6 +46,7 @@ coco -i
 - **`coco recap`** - Summarize recent changes and activity
 - **`coco review`** - AI-powered code review of your changes
 - **`coco log`** - Explore commit history with graph, filters, JSON output, and commit details
+- **`coco ui`** - Open the full-screen Git workstation TUI
 - **`coco init`** - Interactive setup wizard
 
 ## Usage Examples
@@ -88,12 +90,30 @@ coco recap --yesterday
 coco review
 
 # Explore commit history
+coco ui
+coco ui --view status
+coco log --limit 20
+coco log -i
+coco log --view full --limit 20
 coco log --all --limit 20
 coco log --author "Grace Hopper" --path src
 coco log --commit HEAD
 coco log --format json
 ```
 
+### Navigating the TUI
+
+`coco ui` and `coco log -i` share a chord-driven navigation model. Press `g` and then a second key to jump anywhere; `<` (or `Esc`) pops the navigation stack back.
+
+```text
+g h   history          g c   compose         <    back
+g s   status           g b   branches        Esc  back / close modal
+g d   diff             g t   tags            ?    help overlay
+                       g z   stash           :    command palette
+```
+
+The command palette (`:`) is an interactive launcher with fuzzy filter and recently-used at the top — every keybinding and workflow action is reachable from there. `/` searches the active view (history, branches, tags, or stash). See the [Coco UI](https://github.com/gfargo/coco/wiki/Coco-UI) wiki page for the full keymap.
+
 ## Configuration
 
 Configure `coco` for your workflow with the interactive setup wizard:
@@ -116,6 +136,11 @@ coco init --scope project
 {
   "mode": "interactive",
   "conventionalCommits": true,
+  "logTui": {
+    "theme": {
+      "preset": "catppuccin"
+    }
+  },
   "service": {
     "provider": "openai",
     "model": "gpt-4o"
@@ -133,6 +158,8 @@ For comprehensive guides, advanced usage, and detailed configuration options, vi
 - **[Getting Started](https://github.com/gfargo/coco/wiki/Getting-Started)** - Complete beginner's guide from installation to first commit
 - **[Command Reference](https://github.com/gfargo/coco/wiki/Command-Reference)** - Detailed command options and examples
 - **[Configuration Overview](https://github.com/gfargo/coco/wiki/Config-Overview)** - All configuration options and setup methods
+- **[Coco UI](https://github.com/gfargo/coco/wiki/Coco-UI)** - GitKraken-style terminal workstation guide
+- **[Interactive Log TUI](https://github.com/gfargo/coco/wiki/Interactive-Log-TUI)** - History-focused `coco log -i` guide
 - **[Team Collaboration](https://github.com/gfargo/coco/wiki/Team-Collaboration)** - Enterprise deployment and team adoption strategies
 
 **Advanced Resources:**

package/dist/index.d.ts

@@ -1,15 +1,37 @@
 #!/usr/bin/env node
 import * as yargs from 'yargs';
 import { Arguments } from 'yargs';
-import { OllamaInput, ChatOllama } from '@langchain/ollama';
-import { BaseLLMParams } from '@langchain/core/language_models/llms';
 import * as _langchain_openai from '@langchain/openai';
-import { TiktokenModel, OpenAIInput, ChatOpenAI } from '@langchain/openai';
+import { TiktokenModel, ChatOpenAI } from '@langchain/openai';
 import { SimpleGit } from 'simple-git';
 import { ChatAnthropic } from '@langchain/anthropic';
+import { ChatOllama } from '@langchain/ollama';
 import { Color } from 'chalk';
 import { TiktokenModel as TiktokenModel$1 } from 'tiktoken';
 
+type LogInkBorderStyle = 'round' | 'single' | 'classic';
+type LogInkThemePreset = 'default' | 'monochrome' | 'catppuccin' | 'gruvbox';
+type LogInkThemeColors = {
+    accent?: string;
+    border?: string;
+    danger?: string;
+    focusBorder?: string;
+    gitAdded?: string;
+    gitDeleted?: string;
+    gitModified?: string;
+    info?: string;
+    muted?: string;
+    selection?: string;
+    success?: string;
+    warning?: string;
+};
+type LogInkThemeConfig = {
+    ascii?: boolean;
+    borderStyle?: LogInkBorderStyle;
+    colors?: LogInkThemeColors;
+    preset?: LogInkThemePreset;
+};
+
 type LLMProvider = 'openai' | 'ollama' | 'anthropic';
 type DynamicModelTask = 'summarize' | 'commit' | 'changelog' | 'review' | 'recap' | 'repair' | 'largeDiff';
 type DynamicModelPreference = 'cost' | 'balanced' | 'quality';
@@ -94,8 +116,13 @@ type Authentication = {
         apiKey: string;
     };
 };
-type OpenAIFields = Partial<OpenAIInput> & BaseLLMParams;
-type OllamaFields = Partial<OllamaInput> & BaseLLMParams;
+/**
+ * Provider-specific extra options forwarded to the underlying LangChain client.
+ * Decoupled from upstream input types so schema generation stays stable across
+ * langchain releases.
+ */
+type OpenAIFields = Record<string, unknown>;
+type OllamaFields = Record<string, unknown>;
 type OpenAILLMService = BaseLLMService & {
     provider: 'openai';
     model: OpenAIModel | 'dynamic';
@@ -203,6 +230,20 @@ type BaseConfig = {
      * @example { "model": "o4-mini", "approval-mode": "auto-edit" }
      */
     autoFixToolOptions?: Record<string, string>;
+    /**
+     * Interactive log TUI settings.
+     */
+    logTui?: {
+        /**
+         * Theme settings for `coco log -i`.
+         */
+        theme?: LogInkThemeConfig;
+        /**
+         * Rotate short usage tips through the status line when the TUI has been
+         * idle for >10s. Off by default so power users aren't distracted.
+         */
+        idleTips?: boolean;
+    };
 };
 type ConfigWithServiceObject = BaseConfig & Partial<BaseCommandOptions> & {
     service: LLMService;
@@ -230,7 +271,7 @@ interface ChangelogOptions extends BaseCommandOptions {
 }
 type ChangelogArgv = Arguments<ChangelogOptions>;
 
-declare const _default$4: {
+declare const _default$6: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -253,7 +294,7 @@ interface CommitOptions extends BaseCommandOptions {
 }
 type CommitArgv = Arguments<CommitOptions>;
 
-declare const _default$3: {
+declare const _default$5: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -261,15 +302,28 @@ declare const _default$3: {
     options: Record<string, yargs.Options>;
 };
 
+interface DoctorOptions extends BaseCommandOptions {
+    fix?: boolean;
+}
+type DoctorArgv = Arguments<DoctorOptions>;
+
+declare const _default$4: {
+    command: string;
+    desc: string;
+    builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
+    handler: (argv: DoctorArgv) => Promise<void>;
+};
+
 type InstallationScope = 'global' | 'project';
 
-declare const _default$2: {
+declare const _default$3: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
     handler: (argv: {
         [x: string]: unknown;
         scope?: InstallationScope | undefined;
+        dryRun?: boolean | undefined;
         interactive: boolean;
         verbose: boolean;
         version: boolean;
@@ -279,6 +333,7 @@ declare const _default$2: {
     } | Promise<{
         [x: string]: unknown;
         scope?: InstallationScope | undefined;
+        dryRun?: boolean | undefined;
         interactive: boolean;
         verbose: boolean;
         version: boolean;
@@ -290,6 +345,7 @@ declare const _default$2: {
 };
 
 type LogFormat = 'table' | 'json';
+type LogView = 'compact' | 'graph' | 'full';
 interface LogOptions extends BaseCommandOptions {
     all?: boolean;
     author?: string;
@@ -297,14 +353,16 @@ interface LogOptions extends BaseCommandOptions {
     commit?: string;
     format?: LogFormat;
     limit?: number;
+    merges?: boolean;
     noMerges?: boolean;
     path?: string | string[];
     since?: string;
     until?: string;
+    view?: LogView;
 }
 type LogArgv = Arguments<LogOptions>;
 
-declare const _default$1: {
+declare const _default$2: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -322,7 +380,7 @@ interface RecapOptions extends BaseCommandOptions {
 }
 type RecapArgv = Arguments<RecapOptions>;
 
-declare const _default: {
+declare const _default$1: {
     command: string;
     desc: string;
     builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
@@ -330,6 +388,25 @@ declare const _default: {
     options: Record<string, yargs.Options>;
 };
 
+type UiView = 'history' | 'status' | 'diff';
+interface UiOptions extends BaseCommandOptions {
+    all?: boolean;
+    branch?: string;
+    limit?: number;
+    path?: string | string[];
+    theme?: LogInkThemePreset;
+    view?: UiView;
+}
+type UiArgv = Arguments<UiOptions>;
+
+declare const _default: {
+    command: string;
+    desc: string;
+    builder: (yargs: yargs.Argv) => yargs.Argv<yargs.Omit<{}, string> & yargs.InferredOptionTypes<Record<string, yargs.Options>>>;
+    handler: (argv: UiArgv) => Promise<void>;
+    options: Record<string, yargs.Options>;
+};
+
 /**
  * Creates and configures an LLM instance based on the provider and configuration.
  *
@@ -479,5 +556,5 @@ declare namespace types_d {
   export type { types_d_BaseParserInput as BaseParserInput, types_d_BaseParserOptions as BaseParserOptions, types_d_CommandHandler as CommandHandler, types_d_CommitLogParserInput as CommitLogParserInput, types_d_ConfirmMessage as ConfirmMessage, types_d_ConfirmMessageCallback as ConfirmMessageCallback, types_d_DiffNode as DiffNode, types_d_DirectoryDiff as DirectoryDiff, types_d_FileChange as FileChange, types_d_FileChangeParserInput as FileChangeParserInput, types_d_FileChangeStatus as FileChangeStatus, types_d_FileDiff as FileDiff, types_d_GetChangesResult as GetChangesResult };
 }
 
-export { _default$4 as changelog, _default$3 as commit, _default$2 as init, _default$1 as log, _default as recap, types_d as types };
+export { _default$6 as changelog, _default$5 as commit, _default$4 as doctor, _default$3 as init, _default$2 as log, _default$1 as recap, types_d as types, _default as ui };
 export type { Config$1 as Config };