just-git 1.2.7 → 1.2.9

package/README.md

@@ -31,7 +31,7 @@ await bash.exec("echo 'hello' > README.md");
 await bash.exec("git add . && git commit -m 'initial commit'");
 ```
 
-Pass a `Git` instance into [just-bash](https://github.com/vercel-labs/just-bash) as a custom command and you get pipes, redirects, `&&` chaining, and the full shell environment alongside git. For standalone use without just-bash, `MemoryFileSystem` provides a minimal in-memory filesystem and `git.exec` accepts a command string with basic quote-aware splitting:
+Pass a `Git` instance into [just-bash](https://github.com/vercel-labs/just-bash) as a custom command and you get pipes, redirects, `&&` chaining, and the full shell environment alongside git. For standalone use without just-bash, `MemoryFileSystem` provides a minimal in-memory filesystem and `git.exec` accepts a single git command string (no shell features):
 
 ```ts
 import { createGit, MemoryFileSystem } from "just-git";
@@ -39,6 +39,7 @@ import { createGit, MemoryFileSystem } from "just-git";
 const fs = new MemoryFileSystem();
 const git = createGit({
   fs,
+  cwd: "/repo",
   identity: { name: "Alice", email: "alice@example.com" },
   credentials: (url) => ({ type: "bearer", token: process.env.GITHUB_TOKEN! }),
   hooks: {
@@ -49,11 +50,13 @@ const git = createGit({
 });
 
 await git.exec("git init");
-await fs.writeFile("/README.md", "# Hello\n");
+await fs.writeFile("/repo/README.md", "# Hello\n");
 await git.exec("git add .");
 await git.exec('git commit -m "initial commit"');
 ```
 
+Both `fs` and `cwd` can be set once in `createGit` and overridden per-call. `cwd` defaults to `"/"`. Set it to the repo root so every `exec` call finds `.git` automatically.
+
 `createGit` also supports [command restrictions, network policies, and config overrides](docs/CLIENT.md#options) for sandboxing, a [lifecycle hooks API](docs/CLIENT.md#hooks) covering pre-commit secret scanning to push gating, and [cross-VFS remote resolution](docs/CLIENT.md#multi-agent-collaboration) for multi-agent collaboration. See [CLIENT.md](docs/CLIENT.md) for the full reference.
 
 ### Server
@@ -131,16 +134,4 @@ When backed by a real filesystem (e.g. just-bash `ReadWriteFs`), interoperable w
 
 ## Examples
 
-Runnable examples in [`examples/`](examples/):
-
-| File                                                            | What it demonstrates                                                 |
-| --------------------------------------------------------------- | -------------------------------------------------------------------- |
-| [`usage.ts`](examples/usage.ts)                                 | Identity, disabled commands, hooks, compose, full sandbox setup      |
-| [`multi-agent.ts`](examples/multi-agent.ts)                     | Cross-VFS collaboration with clone/push/pull between isolated agents |
-| [`server.ts`](examples/server.ts)                               | VFS-backed Smart HTTP server with virtual client clone and push      |
-| [`sqlite-server.ts`](examples/sqlite-server.ts)                 | SQLite-backed server with auto-creating repos, works with real `git` |
-| [`node-server.mjs`](examples/node-server.mjs)                   | Node.js HTTP server with SQLite + auth via `better-sqlite3`          |
-| [`platform-server.ts`](examples/platform-server.ts)             | GitHub-like PR workflows: create, merge, close via REST API          |
-| [`agent-remote-workflow.ts`](examples/agent-remote-workflow.ts) | Clone from GitHub, work in sandbox, push back (requires token)       |
-
-Run any example with `bun examples/<file>`.
+Runnable examples in [`examples/`](examples/) — identity, hooks, multi-agent collaboration, Smart HTTP servers, and more. Run any with `bun examples/<file>`.

package/dist/index.d.ts

@@ -38,6 +38,12 @@ interface GitOptions {
      * (just-bash always provides its own filesystem).
      */
     fs?: FileSystem;
+    /**
+     * Default working directory for {@link Git.exec}. Defaults to `"/"`.
+     * Per-call `cwd` in {@link ExecContext} overrides this.
+     * Ignored by `execute` (just-bash provides its own cwd).
+     */
+    cwd?: string;
     hooks?: GitHooks;
     credentials?: CredentialProvider;
     identity?: IdentityOverride;
@@ -72,7 +78,7 @@ interface GitOptions {
 interface ExecContext {
     /** Filesystem to operate on. Falls back to the `fs` set in {@link GitOptions}. */
     fs?: FileSystem;
-    /** Working directory. Defaults to `"/"`. */
+    /** Working directory. Falls back to the `cwd` set in {@link GitOptions}, then `"/"`. */
     cwd?: string;
     env?: Record<string, string>;
     stdin?: string;
@@ -92,6 +98,7 @@ interface ExecContext {
 declare class Git {
     readonly name = "git";
     private defaultFs;
+    private defaultCwd;
     private blocked;
     private hooks;
     private inner;