@letta-ai/letta-code 0.1.2 → 0.1.3

package/README.md

@@ -11,34 +11,20 @@ Letta Code is a command-line harness around the stateful Letta [Agents API](http
 
 ## Quickstart
 
-Get an API key at: [https://app.letta.com](https://app.letta.com/)
+> Get a Letta API key at: [https://app.letta.com](https://app.letta.com/)
 
-Install the package via npm:
+Install the package via [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm):
 ```bash
-npm install @letta-ai/letta-code
+npm install -g @letta-ai/letta-code
 ```
 
-Set your API key, and run `letta`:
-```
+Make sure you have your Letta API key set in your environment:
+```bash
 export LETTA_API_KEY=...
-letta
 ```
 
-## Quickstart (from source)
-
-First, install Bun if you don't have it yet: [https://bun.com/docs/installation](https://bun.com/docs/installation)
-
-```bash
-# install deps
-bun install
-
-# run Letta Code
-bun run src/index.ts
-
-# alternatively, install globally to `letta` executable
-bun add --global .
-
-# then, you can run w/ `letta`
+Then run `letta` to start Letta Code (see various command-line options below):
+```
 letta
 ```
 
@@ -106,16 +92,32 @@ Permissions are also configured in `.letta/settings.json`:
 }
 ```
 
----
+## Installing from source
+
+First, install Bun if you don't have it yet: [https://bun.com/docs/installation](https://bun.com/docs/installation)
+
+### Run directly from source (dev workflow)
+```bash
+# install deps
+bun install
+
+# run the CLI from TypeScript sources (pick up changes immediately)
+bun run dev:ui
+bun run dev:ui -- -p "Hello world"  # example with args
+```
 
-To distribute:
+### Build + link the standalone binary
 ```bash
-# build single-file binary
-bun build src/index.ts --compile --outfile letta
+# build bin/letta (includes prompts + schemas)
+bun run build
+
+# expose the binary globally (adjust to your preference)
+bun link --global   # or: bun add --global .
 
-# optionally copy to bin
-sudo mv letta /usr/local/bin/
+# now you can run the compiled CLI
+letta
 ```
+> Whenever you change source files, rerun `bun run build` before using the linked `letta` binary so it picks up your edits.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",
   "bin": {
@@ -22,7 +22,6 @@
     "access": "public"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.2.5",
     "@types/bun": "latest",
     "@types/diff": "^8.0.0",
     "typescript": "^5.0.0",
@@ -39,8 +38,8 @@
     "react": "18.2.0"
   },
   "scripts": {
-    "lint": "biome check src",
-    "fix": "biome check --write src",
+    "lint": "bunx --bun @biomejs/biome@2.2.5 check src",
+    "fix": "bunx --bun @biomejs/biome@2.2.5 check --write src",
     "dev:ui": "bun --loader:.md=text --loader:.mdx=text --loader:.txt=text run src/index.ts",
     "build": "bun build src/index.ts --compile --loader:.md=text --loader:.mdx=text --loader:.txt=text --outfile bin/letta",
     "prepublishOnly": "bun run build",
@@ -48,7 +47,7 @@
   },
   "lint-staged": {
     "*.{ts,tsx,js,jsx,json,md}": [
-      "biome check --write"
+      "bunx --bun @biomejs/biome@2.2.5 check --write"
     ]
   }
 }

package/scripts/postinstall-patches.js

@@ -92,10 +92,7 @@ await copyToResolved(
   "vendor/ink/build/hooks/use-input.js",
   "ink/build/hooks/use-input.js",
 );
-await copyToResolved(
-  "vendor/ink/build/devtools.js",
-  "ink/build/devtools.js",
-);
+await copyToResolved("vendor/ink/build/devtools.js", "ink/build/devtools.js");
 
 // ink-text-input (optional vendor with externalCursorOffset support)
 await copyToResolved(