@sworddut/myclaw 0.1.0 → 0.1.1

package/README.md

@@ -18,18 +18,27 @@ A CLI coding agent scaffold (TypeScript + oclif).
 ```bash
 npm install
 npm run build
-cp .env.example .env
-# fill OPENAI_API_KEY in .env
-# optional: set model in env
-# OPENAI_MODEL=gpt-4o-mini
-# optional: for openai-compatible third-party endpoint
-# OPENAI_BASE_URL=https://your-endpoint/v1
 node ./bin/run.js init -f
+# then fill credentials in ~/.myclaw/.env (or $MYCLAW_HOME/.env)
 ```
 
 `OPENAI_BASE_URL` and `.myclawrc.json` `baseURL` both support OpenAI-compatible providers.
 Model priority: `.myclawrc.json` `model` > `OPENAI_MODEL` > `gpt-4o-mini`.
 
+## Global Home Directory
+
+- Default home: `~/.myclaw`
+- Override with env: `MYCLAW_HOME=/custom/path`
+- Global env file: `~/.myclaw/.env`
+- Memory file: `~/.myclaw/memory.md`
+
+Create your global env:
+
+```bash
+cp ~/.myclaw/.env.example ~/.myclaw/.env
+# edit ~/.myclaw/.env
+```
+
 ## Commands
 
 ```bash

package/dist/commands/init.js

@@ -1,26 +1,34 @@
 import { Command, Flags } from '@oclif/core';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
+import { getMemoryPath, getMyclawHome } from '../config/paths.js';
 export default class Init extends Command {
-    static description = 'Initialize myclaw config in current directory';
+    static description = 'Initialize local project config and global myclaw home';
     static flags = {
         force: Flags.boolean({ char: 'f', description: 'overwrite existing config' })
     };
     async run() {
         const { flags } = await this.parse(Init);
         const targetDir = process.cwd();
+        const homeDir = getMyclawHome();
+        const memoryPath = getMemoryPath();
         const configPath = resolve(targetDir, '.myclawrc.json');
-        const envPath = resolve(targetDir, '.env.example');
+        const globalEnvExamplePath = resolve(homeDir, '.env.example');
         await mkdir(targetDir, { recursive: true });
+        await mkdir(homeDir, { recursive: true });
         await writeFile(configPath, JSON.stringify({
             provider: 'openai',
             model: '',
             baseURL: '',
-            workspace: targetDir
+            workspace: targetDir,
+            homeDir,
+            memoryFile: memoryPath
         }, null, 2) + '\n', { flag: flags.force ? 'w' : 'wx' });
-        await writeFile(envPath, 'OPENAI_API_KEY=\nOPENAI_MODEL=gpt-4o-mini\nOPENAI_BASE_URL=\nANTHROPIC_API_KEY=\n', { flag: flags.force ? 'w' : 'wx' });
+        await writeFile(globalEnvExamplePath, 'OPENAI_API_KEY=\nOPENAI_MODEL=gpt-4o-mini\nOPENAI_BASE_URL=\nANTHROPIC_API_KEY=\n', { flag: flags.force ? 'w' : 'wx' });
+        await writeFile(memoryPath, '# myclaw memory\n\n- Add durable preferences and project notes here.\n', { flag: flags.force ? 'w' : 'wx' });
         this.log(`Created ${configPath}`);
-        this.log(`Created ${envPath}`);
+        this.log(`Created ${globalEnvExamplePath}`);
+        this.log(`Created ${memoryPath}`);
     }
 }
 //# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAC,KAAK,EAAE,SAAS,EAAC,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAEjC,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAU,WAAW,GAAG,+CAA+C,CAAA;IAE7E,MAAM,CAAU,KAAK,GAAG;QACtB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,2BAA2B,EAAC,CAAC;KAC5E,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;QACvD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;QAElD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAA;QACzC,MAAM,SAAS,CACb,UAAU,EACV,IAAI,CAAC,SAAS,CACZ;YACE,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,SAAS;SACrB,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,EAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAC,CACjC,CAAA;QAED,MAAM,SAAS,CACb,OAAO,EACP,mFAAmF,EACnF,EAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAC,CACjC,CAAA;QAED,IAAI,CAAC,GAAG,CAAC,WAAW,UAAU,EAAE,CAAC,CAAA;QACjC,IAAI,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,CAAC,CAAA;IAChC,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAC,KAAK,EAAE,SAAS,EAAC,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAA;AAE/D,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAU,WAAW,GAAG,wDAAwD,CAAA;IAEtF,MAAM,CAAU,KAAK,GAAG;QACtB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,2BAA2B,EAAC,CAAC;KAC5E,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAC/B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAA;QAC/B,MAAM,UAAU,GAAG,aAAa,EAAE,CAAA;QAClC,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;QACvD,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;QAE7D,MAAM,KAAK,CAAC,SAAS,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAA;QACzC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAA;QACvC,MAAM,SAAS,CACb,UAAU,EACV,IAAI,CAAC,SAAS,CACZ;YACE,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,SAAS;YACpB,OAAO;YACP,UAAU,EAAE,UAAU;SACvB,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,EAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAC,CACjC,CAAA;QAED,MAAM,SAAS,CACb,oBAAoB,EACpB,mFAAmF,EACnF,EAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAC,CACjC,CAAA;QACD,MAAM,SAAS,CACb,UAAU,EACV,wEAAwE,EACxE,EAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAC,CACjC,CAAA;QAED,IAAI,CAAC,GAAG,CAAC,WAAW,UAAU,EAAE,CAAC,CAAA;QACjC,IAAI,CAAC,GAAG,CAAC,WAAW,oBAAoB,EAAE,CAAC,CAAA;QAC3C,IAAI,CAAC,GAAG,CAAC,WAAW,UAAU,EAAE,CAAC,CAAA;IACnC,CAAC"}

package/dist/config/load-config.js

@@ -1,6 +1,8 @@
 import { cosmiconfig } from 'cosmiconfig';
 import dotenv from 'dotenv';
 import { appConfigSchema } from './schema.js';
+import { getGlobalEnvPath } from './paths.js';
+dotenv.config({ path: getGlobalEnvPath() });
 dotenv.config();
 export async function loadConfig() {
     const explorer = cosmiconfig('myclaw');

package/dist/config/load-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAA;AACvC,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAC,eAAe,EAAiB,MAAM,aAAa,CAAA;AAE3D,MAAM,CAAC,MAAM,EAAE,CAAA;AAEf,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAA;IACtC,OAAO,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAA;AACpD,CAAC"}
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAA;AACvC,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAC,eAAe,EAAiB,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAC,gBAAgB,EAAC,MAAM,YAAY,CAAA;AAE3C,MAAM,CAAC,MAAM,CAAC,EAAC,IAAI,EAAE,gBAAgB,EAAE,EAAC,CAAC,CAAA;AACzC,MAAM,CAAC,MAAM,EAAE,CAAA;AAEf,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAA;IACtC,OAAO,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAA;AACpD,CAAC"}

package/dist/config/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function getMyclawHome(): string;
+export declare function getGlobalEnvPath(): string;
+export declare function getMemoryPath(): string;

package/dist/config/paths.js

@@ -0,0 +1,15 @@
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+export function getMyclawHome() {
+    const custom = process.env.MYCLAW_HOME?.trim();
+    if (custom)
+        return resolve(custom);
+    return resolve(homedir(), '.myclaw');
+}
+export function getGlobalEnvPath() {
+    return resolve(getMyclawHome(), '.env');
+}
+export function getMemoryPath() {
+    return resolve(getMyclawHome(), 'memory.md');
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAEjC,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAA;IAC9C,IAAI,MAAM;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;IAClC,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,aAAa,EAAE,EAAE,WAAW,CAAC,CAAA;AAC9C,CAAC"}

package/dist/config/schema.d.ts

@@ -1,18 +1,38 @@
 import { z } from 'zod';
-export declare const appConfigSchema: z.ZodObject<{
+export declare const appConfigSchema: z.ZodEffects<z.ZodObject<{
     provider: z.ZodDefault<z.ZodEnum<["mock", "openai", "anthropic"]>>;
     model: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, unknown>;
     baseURL: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, unknown>;
     workspace: z.ZodDefault<z.ZodString>;
+    homeDir: z.ZodDefault<z.ZodString>;
+    memoryFile: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     provider: "mock" | "openai" | "anthropic";
     workspace: string;
+    homeDir: string;
     model?: string | undefined;
     baseURL?: string | undefined;
+    memoryFile?: string | undefined;
 }, {
     provider?: "mock" | "openai" | "anthropic" | undefined;
     model?: unknown;
     baseURL?: unknown;
     workspace?: string | undefined;
+    homeDir?: string | undefined;
+    memoryFile?: string | undefined;
+}>, {
+    memoryFile: string;
+    provider: "mock" | "openai" | "anthropic";
+    workspace: string;
+    homeDir: string;
+    model?: string | undefined;
+    baseURL?: string | undefined;
+}, {
+    provider?: "mock" | "openai" | "anthropic" | undefined;
+    model?: unknown;
+    baseURL?: unknown;
+    workspace?: string | undefined;
+    homeDir?: string | undefined;
+    memoryFile?: string | undefined;
 }>;
 export type AppConfig = z.infer<typeof appConfigSchema>;

package/dist/config/schema.js

@@ -1,8 +1,14 @@
 import { z } from 'zod';
+import { getMemoryPath, getMyclawHome } from './paths.js';
 export const appConfigSchema = z.object({
     provider: z.enum(['mock', 'openai', 'anthropic']).default('openai'),
     model: z.preprocess((value) => (typeof value === 'string' && value.trim() === '' ? undefined : value), z.string().trim().optional()),
     baseURL: z.preprocess((value) => (typeof value === 'string' && value.trim() === '' ? undefined : value), z.string().trim().optional()),
-    workspace: z.string().default(process.cwd())
-});
+    workspace: z.string().default(process.cwd()),
+    homeDir: z.string().default(getMyclawHome()),
+    memoryFile: z.string().optional()
+}).transform((config) => ({
+    ...config,
+    memoryFile: config.memoryFile ?? getMemoryPath()
+}));
 //# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAA;AAErB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,UAAU,CACjB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EACjF,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAC7B;IACD,OAAO,EAAE,CAAC,CAAC,UAAU,CACnB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EACjF,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAC7B;IACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;CAC7C,CAAC,CAAA"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAA;AACrB,OAAO,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,YAAY,CAAA;AAEvD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,UAAU,CACjB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EACjF,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAC7B;IACD,OAAO,EAAE,CAAC,CAAC,UAAU,CACnB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EACjF,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAC7B;IACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxB,GAAG,MAAM;IACT,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,aAAa,EAAE;CACjD,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sworddut/myclaw",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "description": "A CLI coding agent inspired by Claude Code",
   "type": "module",