@gajae-code/coding-agent 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-05-30
+
+### Fixed
+
+- Added a `gjc skills` inspection command so installed binaries can list and read embedded workflow skills from any project without relying on source-tree `.gjc` files.
+- Fixed first-run API provider onboarding so `models.yml` parent directories are created before writing, and malformed `/provicer` startup invocations now report the intended `/provider add` spelling instead of falling through to model bootstrap.
+
 ## [0.2.0] - 2026-05-28
 
 ### Added

package/dist/types/cli/skills-cli.d.ts

@@ -0,0 +1,9 @@
+export type SkillsAction = "list" | "read";
+export interface SkillsCommandArgs {
+    action: SkillsAction;
+    name?: string;
+    flags?: {
+        json?: boolean;
+    };
+}
+export declare function runSkillsCommand(cmd: SkillsCommandArgs): Promise<void>;

package/dist/types/commands/skills.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Inspect bundled workflow skills.
+ */
+import { Command } from "@gajae-code/utils/cli";
+import { type SkillsAction } from "../cli/skills-cli";
+export default class Skills extends Command {
+    static description: string;
+    static args: {
+        action: import("@gajae-code/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: SkillsAction[];
+        };
+        name: import("@gajae-code/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+    };
+    static flags: {
+        json: import("@gajae-code/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/config/model-registry.d.ts

@@ -1,4 +1,4 @@
-import { type Api, type AssistantMessageEventStream, type Context, type Model, type ModelRefreshStrategy, type SimpleStreamOptions, type ThinkingConfig } from "@gajae-code/ai";
+import { type Api, type AssistantMessageEventStream, type Context, type Model, type ModelRefreshStrategy, type ModelRequestTransform, type SimpleStreamOptions, type ThinkingConfig } from "@gajae-code/ai";
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@gajae-code/ai/utils/oauth/types";
 import { type ThemeColor } from "../modes/theme/theme";
 import type { AuthStorage } from "../session/auth-storage";
@@ -88,6 +88,12 @@ export declare const ModelsConfigFile: ConfigFile<{
         discovery?: {
             type: "llama.cpp" | "lm-studio" | "ollama" | "openai-models-list";
         } | undefined;
+        requestTransform?: {
+            profile?: "openai-proxy" | undefined;
+            stripHeaders?: string[] | undefined;
+            setHeaders?: Record<string, string | null> | undefined;
+            extraBody?: Record<string, unknown> | undefined;
+        } | undefined;
         models?: {
             id: string;
             name?: string | undefined;
@@ -151,6 +157,13 @@ export declare const ModelsConfigFile: ConfigFile<{
                 toolStrictMode?: "all_strict" | "none" | undefined;
             } | undefined;
             contextPromotionTarget?: string | undefined;
+            wireModelId?: string | undefined;
+            requestTransform?: {
+                profile?: "openai-proxy" | undefined;
+                stripHeaders?: string[] | undefined;
+                setHeaders?: Record<string, string | null> | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+            } | undefined;
         }[] | undefined;
         modelOverrides?: Record<string, {
             name?: string | undefined;
@@ -212,10 +225,21 @@ export declare const ModelsConfigFile: ConfigFile<{
                 toolStrictMode?: "all_strict" | "none" | undefined;
             } | undefined;
             contextPromotionTarget?: string | undefined;
+            wireModelId?: string | undefined;
+            requestTransform?: {
+                profile?: "openai-proxy" | undefined;
+                stripHeaders?: string[] | undefined;
+                setHeaders?: Record<string, string | null> | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+            } | undefined;
         }> | undefined;
         disableStrictTools?: boolean | undefined;
         transport?: "pi-native" | undefined;
     }> | undefined;
+    modelBindings?: {
+        modelRoles?: Record<string, string> | undefined;
+        agentModelOverrides?: Record<string, string> | undefined;
+    } | undefined;
     equivalence?: {
         overrides?: Record<string, string> | undefined;
         exclude?: string[] | undefined;
@@ -229,6 +253,7 @@ interface ProviderOverride {
     authHeader?: boolean;
     compat?: Model<Api>["compat"];
     transport?: Model<Api>["transport"];
+    requestTransform?: ModelRequestTransform;
 }
 /**
  * Merge a freshly discovered model with the matching bundled/configured entry
@@ -246,7 +271,7 @@ interface ProviderOverride {
  * See `xiaomi-tp-discovery-merge.test.ts` and the `refresh()` baseUrl-override
  * regression in `model-registry.test.ts`.
  */
-export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "transport">): Model<TApi>;
+export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "transport" | "requestTransform">): Model<TApi>;
 export type ProviderDiscoveryStatus = "idle" | "ok" | "empty" | "cached" | "unavailable" | "unauthenticated";
 export interface ProviderDiscoveryState {
     provider: string;
@@ -281,6 +306,7 @@ export declare class ModelRegistry {
      * Get any error from loading models.json (undefined if no error).
      */
     getError(): ConfigError | undefined;
+    applyConfiguredModelBindings(targetSettings: Settings): void;
     /**
      * Get all models (built-in + custom).
      * If models.json had errors, returns only built-in models.
@@ -364,6 +390,7 @@ export interface ProviderConfigInput {
     streamSimple?: (model: Model<Api>, context: Context, options?: SimpleStreamOptions) => AssistantMessageEventStream;
     headers?: Record<string, string>;
     compat?: Model<Api>["compat"];
+    requestTransform?: ModelRequestTransform;
     authHeader?: boolean;
     /** Streaming transport override — see {@link Model.transport}. */
     transport?: Model<Api>["transport"];
@@ -392,6 +419,8 @@ export interface ProviderConfigInput {
         maxTokens: number;
         headers?: Record<string, string>;
         compat?: Model<Api>["compat"];
+        requestTransform?: ModelRequestTransform;
+        wireModelId?: string;
         contextPromotionTarget?: string;
         premiumMultiplier?: number;
     }>;

package/dist/types/config/models-config-schema.d.ts

@@ -162,6 +162,15 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     contextPromotionTarget: z.ZodOptional<z.ZodString>;
+    wireModelId: z.ZodOptional<z.ZodString>;
+    requestTransform: z.ZodOptional<z.ZodObject<{
+        profile: z.ZodOptional<z.ZodEnum<{
+            "openai-proxy": "openai-proxy";
+        }>>;
+        stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+        extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ModelOverride = z.infer<typeof ModelOverrideSchema>;
 export declare const ProviderDiscoverySchema: z.ZodObject<{
@@ -262,6 +271,14 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 "openai-models-list": "openai-models-list";
             }>;
         }, z.core.$strip>>;
+        requestTransform: z.ZodOptional<z.ZodObject<{
+            profile: z.ZodOptional<z.ZodEnum<{
+                "openai-proxy": "openai-proxy";
+            }>>;
+            stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+            extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
         models: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodOptional<z.ZodString>;
@@ -382,6 +399,15 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strip>>;
             contextPromotionTarget: z.ZodOptional<z.ZodString>;
+            wireModelId: z.ZodOptional<z.ZodString>;
+            requestTransform: z.ZodOptional<z.ZodObject<{
+                profile: z.ZodOptional<z.ZodEnum<{
+                    "openai-proxy": "openai-proxy";
+                }>>;
+                stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+                extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>>;
         modelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
@@ -492,10 +518,23 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strip>>;
             contextPromotionTarget: z.ZodOptional<z.ZodString>;
+            wireModelId: z.ZodOptional<z.ZodString>;
+            requestTransform: z.ZodOptional<z.ZodObject<{
+                profile: z.ZodOptional<z.ZodEnum<{
+                    "openai-proxy": "openai-proxy";
+                }>>;
+                stripHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                setHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
+                extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>>;
         disableStrictTools: z.ZodOptional<z.ZodBoolean>;
         transport: z.ZodOptional<z.ZodLiteral<"pi-native">>;
     }, z.core.$strip>>>;
+    modelBindings: z.ZodOptional<z.ZodObject<{
+        modelRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        agentModelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
     equivalence: z.ZodOptional<z.ZodObject<{
         overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/types/modes/components/model-selector.d.ts

@@ -5,6 +5,26 @@ import type { GjcModelAssignmentTargetId, ModelRegistry } from "../../config/mod
 import { type ScopedModelSelection } from "../../config/model-resolver";
 import type { Settings } from "../../config/settings";
 type ScopedModelItem = ScopedModelSelection;
+export interface ModelAssignmentPreset {
+    id: "openai-codex";
+    label: string;
+    description: string;
+    assignments: Partial<Record<GjcModelAssignmentTargetId, ThinkingLevel>>;
+}
+export type ModelSelectorSelection = {
+    kind: "assignment";
+    model: Model;
+    role: GjcModelAssignmentTargetId | null;
+    thinkingLevel?: ThinkingLevel;
+    selector?: string;
+} | {
+    kind: "preset";
+    model: Model;
+    selector: string;
+    preset: ModelAssignmentPreset;
+    assignments: Record<GjcModelAssignmentTargetId, ThinkingLevel>;
+};
+type RoleSelectCallback = (selection: ModelSelectorSelection) => void;
 /**
  * Component that renders a canonical model selector with provider tabs.
  * - Tab/Arrow Left/Right: Switch between provider tabs
@@ -14,7 +34,7 @@ type ScopedModelItem = ScopedModelSelection;
  */
 export declare class ModelSelectorComponent extends Container {
     #private;
-    constructor(tui: TUI, _currentModel: Model | undefined, settings: Settings, modelRegistry: ModelRegistry, scopedModels: ReadonlyArray<ScopedModelItem>, onSelect: (model: Model, role: GjcModelAssignmentTargetId | null, thinkingLevel?: ThinkingLevel, selector?: string) => void, onCancel: () => void, options?: {
+    constructor(tui: TUI, _currentModel: Model | undefined, settings: Settings, modelRegistry: ModelRegistry, scopedModels: ReadonlyArray<ScopedModelItem>, onSelect: RoleSelectCallback, onCancel: () => void, options?: {
         temporaryOnly?: boolean;
         initialSearchInput?: string;
     });

package/dist/types/slash-commands/builtin-registry.d.ts

@@ -2,6 +2,7 @@ import type { BuiltinSlashCommand, ParsedSlashCommand, SlashCommandResult, Slash
 export type { BuiltinSlashCommand, SubcommandDef } from "./types";
 /** TUI-specific runtime accepted by `executeBuiltinSlashCommand`. */
 export type BuiltinSlashCommandRuntime = TuiSlashCommandRuntime;
+export declare function formatUnknownBuiltinSlashCommandDiagnostic(commandName: string): string | undefined;
 /** Builtin command metadata used for slash-command autocomplete and help text. */
 export declare const BUILTIN_SLASH_COMMAND_DEFS: ReadonlyArray<BuiltinSlashCommand>;
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"description": "Gajae Code CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://gaebal-gajae.dev",
 	"author": "Yeachan-Heo",
@@ -48,12 +48,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@gajae-code/stats": "0.2.0",
-		"@gajae-code/agent-core": "0.2.0",
-		"@gajae-code/ai": "0.2.0",
-		"@gajae-code/natives": "0.2.0",
-		"@gajae-code/tui": "0.2.0",
-		"@gajae-code/utils": "0.2.0",
+		"@gajae-code/stats": "0.2.1",
+		"@gajae-code/agent-core": "0.2.1",
+		"@gajae-code/ai": "0.2.1",
+		"@gajae-code/natives": "0.2.1",
+		"@gajae-code/tui": "0.2.1",
+		"@gajae-code/utils": "0.2.1",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/src/cli/args.ts

@@ -55,6 +55,15 @@ export interface Args {
 	unknownFlags: Map<string, boolean | string>;
 }
 
+function isStartupSlashCommandArg(arg: string | undefined): boolean {
+	return (
+		arg === "/provider" ||
+		arg?.startsWith("/provider:") === true ||
+		arg === "/provicer" ||
+		arg?.startsWith("/provicer:") === true
+	);
+}
+
 export function parseArgs(args: string[]): Args {
 	const result: Args = {
 		messages: [],
@@ -65,6 +74,11 @@ export function parseArgs(args: string[]): Args {
 	for (let i = 0; i < args.length; i++) {
 		let arg = args[i];
 
+		if (isStartupSlashCommandArg(arg)) {
+			result.messages.push(args.slice(i).join(" "));
+			break;
+		}
+
 		// Support --flag=value syntax (e.g. --tools=ask,read)
 		if (arg.startsWith("--") && arg.includes("=")) {
 			const eqIdx = arg.indexOf("=");

package/src/cli/skills-cli.ts

@@ -0,0 +1,88 @@
+/**
+ * Handles `gjc skills` for inspecting bundled workflow skill definitions.
+ */
+import {
+	DEFAULT_GJC_DEFINITION_NAMES,
+	type EmbeddedDefaultGjcSkill,
+	getEmbeddedDefaultGjcSkills,
+} from "../defaults/gjc-defaults";
+
+export type SkillsAction = "list" | "read";
+
+export interface SkillsCommandArgs {
+	action: SkillsAction;
+	name?: string;
+	flags?: {
+		json?: boolean;
+	};
+}
+
+interface SkillsListEntry {
+	name: string;
+	description: string;
+	path: string;
+	source: string;
+}
+
+interface SkillsReadEntry extends SkillsListEntry {
+	content: string;
+}
+
+function getEmbeddedSkill(name: string): EmbeddedDefaultGjcSkill | undefined {
+	return getEmbeddedDefaultGjcSkills().find(skill => skill.name === name);
+}
+
+function listEmbeddedSkills(): SkillsListEntry[] {
+	return getEmbeddedDefaultGjcSkills().map(skill => ({
+		name: skill.name,
+		description: skill.description,
+		path: skill.filePath,
+		source: skill.source,
+	}));
+}
+
+function writeJson(value: unknown): void {
+	process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+
+export async function runSkillsCommand(cmd: SkillsCommandArgs): Promise<void> {
+	if (cmd.action === "list") {
+		const skills = listEmbeddedSkills();
+		if (cmd.flags?.json) {
+			writeJson({ skills });
+			return;
+		}
+		for (const skill of skills) {
+			process.stdout.write(`${skill.name}\t${skill.description}\t${skill.path}\n`);
+		}
+		return;
+	}
+
+	const name = cmd.name?.trim();
+	if (!name) {
+		process.stderr.write(`error: skill name is required for read (${DEFAULT_GJC_DEFINITION_NAMES.join(", ")})\n`);
+		process.exitCode = 1;
+		return;
+	}
+
+	const skill = getEmbeddedSkill(name);
+	if (!skill) {
+		process.stderr.write(`error: unknown embedded skill "${name}" (${DEFAULT_GJC_DEFINITION_NAMES.join(", ")})\n`);
+		process.exitCode = 1;
+		return;
+	}
+
+	const entry: SkillsReadEntry = {
+		name: skill.name,
+		description: skill.description,
+		path: skill.filePath,
+		source: skill.source,
+		content: skill.content,
+	};
+	if (cmd.flags?.json) {
+		writeJson(entry);
+		return;
+	}
+	process.stdout.write(skill.content);
+	if (!skill.content.endsWith("\n")) process.stdout.write("\n");
+}

package/src/cli.ts

@@ -34,6 +34,7 @@ const commands: CommandEntry[] = [
 	{ name: "question", load: () => import("./commands/question").then(m => m.default) },
 	{ name: "state", load: () => import("./commands/state").then(m => m.default) },
 	{ name: "setup", load: () => import("./commands/setup").then(m => m.default) },
+	{ name: "skills", load: () => import("./commands/skills").then(m => m.default) },
 	{ name: "team", load: () => import("./commands/team").then(m => m.default) },
 	{ name: "ultragoal", load: () => import("./commands/ultragoal").then(m => m.default) },
 	{ name: "ralplan", load: () => import("./commands/ralplan").then(m => m.default) },

package/src/commands/skills.ts

@@ -0,0 +1,48 @@
+/**
+ * Inspect bundled workflow skills.
+ */
+import { Args, Command, Flags, renderCommandHelp } from "@gajae-code/utils/cli";
+import { runSkillsCommand, type SkillsAction, type SkillsCommandArgs } from "../cli/skills-cli";
+
+const ACTIONS: SkillsAction[] = ["list", "read"];
+
+export default class Skills extends Command {
+	static description = "Inspect bundled GJC workflow skills";
+
+	static args = {
+		action: Args.string({
+			description: "Skills action",
+			required: false,
+			options: ACTIONS,
+		}),
+		name: Args.string({
+			description: "Bundled skill name to read",
+			required: false,
+		}),
+	};
+
+	static flags = {
+		json: Flags.boolean({ description: "Output JSON" }),
+	};
+
+	static examples = [
+		"# List bundled workflow skills\n  gjc skills list",
+		"# Read an embedded workflow skill without requiring .gjc files\n  gjc skills read ultragoal",
+		"# Machine-readable embedded skill content\n  gjc skills read ralplan --json",
+	];
+
+	async run(): Promise<void> {
+		const { args, flags } = await this.parse(Skills);
+		if (!args.action) {
+			renderCommandHelp("gjc", "skills", Skills);
+			return;
+		}
+
+		const cmd: SkillsCommandArgs = {
+			action: args.action as SkillsAction,
+			name: args.name,
+			flags: { json: flags.json },
+		};
+		await runSkillsCommand(cmd);
+	}
+}

package/src/commit/agentic/index.ts

@@ -31,6 +31,7 @@ export async function runAgenticCommit(args: CommitCommandArgs): Promise<void> {
 	process.stdout.write("● Resolving model...\n");
 	const modelRegistry = new ModelRegistry(authStorage);
 	await modelRegistry.refresh();
+	modelRegistry.applyConfiguredModelBindings(settings);
 	const stagedFilesPromise = (async () => {
 		let stagedFiles = await git.diff.changedFiles(cwd, { cached: true });
 		if (stagedFiles.length === 0) {

package/src/commit/pipeline.ts

@@ -45,6 +45,7 @@ async function runLegacyCommitCommand(args: CommitCommandArgs): Promise<void> {
 	const authStorage = await discoverAuthStorage();
 	const modelRegistry = new ModelRegistry(authStorage);
 	await modelRegistry.refresh();
+	modelRegistry.applyConfiguredModelBindings(settings);
 
 	const {
 		model: primaryModel,