agentrealm 0.1.0 → 1.0.0

package/README.md

@@ -12,7 +12,7 @@
 
 A **realm** is a lightweight, agentless sandbox workspace for AI agents.
 
-In a traditional agent workspace, one agent permanently guards the space — it's always watching, always running. A realm is different: **no agent lives there**. Any AI agent (or human) can enter when needed, do focused work, and leave. When the objective is complete, the realm is sealed.
+In a traditional agent workspace, one agent permanently guards the space — it's always watching, always running. A realm is different: **no agent lives there**. Any AI agent (or human) can enter when needed, do focused work, and leave. When the work is complete, simply delete the realm or keep it archived.
 
 Think of it as a shared project folder with built-in structure, a context loader, and a work diary — designed to be understood and entered by any agent without prior knowledge of the project.
 
@@ -23,7 +23,7 @@ Think of it as a shared project folder with built-in structure, a context loader
 | Persistent agent | ✅ Always watching | ❌ Agentless |
 | Entry model | One dedicated agent | Any agent |
 | Context loading | Agent-managed | `realm prompt <name>` |
-| Lifecycle | Ongoing | Scoped → seal when done |
+| Lifecycle | Ongoing | Scoped → delete when done |
 | Use case | Long-lived assistant | Focused task or project |
 | Overhead | High | Low |
 
@@ -51,14 +51,14 @@ realm prompt my-project
 # Copy context to clipboard (then paste into your agent)
 realm prompt my-project --copy
 
-# List all active realms
+# List all realms
 realm ls
 
 # Add a diary entry
 realm diary my-project "Finished the API integration, tests passing"
 
-# Seal when done
-realm seal my-project
+# When you're done, you can delete the realm or leave it archived
+# realm rm my-project --purge
 ```
 
 ---
@@ -68,11 +68,9 @@ realm seal my-project
 | Command | Description |
 |---------|-------------|
 | `realm new <name> [--dir <path>] [--with-diary]` | Create a new realm |
-| `realm ls [--all]` | List realms (active by default; `--all` includes sealed) |
+| `realm ls` | List realms |
 | `realm cd <name>` | Print realm directory (`cd $(realm cd foo)`) |
 | `realm prompt <name>` | Build context bundle — stdout, clipboard, or file |
-| `realm seal <name>` | Seal a realm (mark complete) |
-| `realm unseal <name>` | Unseal a realm (reactivate) |
 | `realm rm <name> [--purge] [--yes]` | Remove from registry; `--purge` deletes directory |
 | `realm diary <name> [message]` | Append diary entry or open in `$EDITOR` |
 | `realm skill` | Print path to bundled SKILL.md |
@@ -109,9 +107,7 @@ version: 1
 realms:
   my-project:
     dir: /Users/you/realms/my-project
-    status: active
     created: 2026-04-18T08:55:00.000Z
-    sealed_at: null
     description: ""
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentrealm",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Agentless sandbox workspaces for AI agents",
   "type": "module",
   "engines": {

package/skill/SKILL.md

@@ -16,7 +16,7 @@ install: npm i -g agentrealm
 
 A **realm** is an agentless sandbox workspace. Unlike an agent workspace where a dedicated agent
 permanently guards the space, realms are ephemeral collaboration zones. Any agent can enter,
-work, and leave. Realms are sealed when the work is done.
+work, and leave.
 
 ## When This Skill Applies
 
@@ -47,10 +47,9 @@ context block. Paste it into your session or use `--copy` to get it on the clipb
    realm diary <name> "Brief note: what you did, what's next"
    ```
 
-## Leaving / Sealing
+## Leaving
 
 - Leave freely — no cleanup required beyond a diary note
-- Seal when the work is fully done: `realm seal <name>`
 
 ## Common Commands
 
@@ -58,9 +57,8 @@ context block. Paste it into your session or use `--copy` to get it on the clipb
 |---------|-------------|
 | `realm new <name>` | Create a new realm |
 | `realm prompt <name>` | Load realm context |
-| `realm ls` | List active realms |
+| `realm ls` | List realms |
 | `realm diary <name> "msg"` | Log a diary entry |
-| `realm seal <name>` | Seal a completed realm |
 | `realm cd <name>` | Get realm directory path |
 
 ## Finding This Skill

package/src/cli.js

@@ -7,8 +7,6 @@ import { newCommand } from './commands/new.js';
 import { lsCommand } from './commands/ls.js';
 import { cdCommand } from './commands/cd.js';
 import { promptCommand } from './commands/prompt.js';
-import { sealCommand } from './commands/seal.js';
-import { unsealCommand } from './commands/unseal.js';
 import { rmCommand } from './commands/rm.js';
 import { diaryCommand } from './commands/diary.js';
 import { skillCommand } from './commands/skill.js';
@@ -27,8 +25,6 @@ newCommand(program);
 lsCommand(program);
 cdCommand(program);
 promptCommand(program);
-sealCommand(program);
-unsealCommand(program);
 rmCommand(program);
 diaryCommand(program);
 skillCommand(program);

package/src/commands/ls.js

@@ -5,36 +5,27 @@ export function lsCommand(program) {
   program
     .command('ls')
     .description('List realms')
-    .option('--all', 'Include sealed realms')
-    .action((opts) => {
+    .action(() => {
       const registry = readRegistry();
       const realms = Object.entries(registry.realms || {});
 
-      const filtered = opts.all
-        ? realms
-        : realms.filter(([, r]) => r.status !== 'sealed');
-
-      if (filtered.length === 0) {
+      if (realms.length === 0) {
         console.log('No realms found. Create one with: realm new <name>');
         return;
       }
 
-      const col1 = Math.max(4, ...filtered.map(([n]) => n.length));
-      const col2 = 8;
-      const col3 = Math.max(3, ...filtered.map(([, r]) => r.dir.length));
+      const col1 = Math.max(4, ...realms.map(([n]) => n.length));
+      const col2 = Math.max(3, ...realms.map(([, r]) => r.dir.length));
 
       const header =
         chalk.bold('NAME'.padEnd(col1)) + '  ' +
-        chalk.bold('STATUS'.padEnd(col2)) + '  ' +
         chalk.bold('DIR');
       console.log(header);
-      console.log('─'.repeat(col1 + col2 + col3 + 4));
+      console.log('─'.repeat(col1 + col2 + 2));
 
-      for (const [name, realm] of filtered) {
-        const statusColor = realm.status === 'sealed' ? chalk.gray : chalk.green;
+      for (const [name, realm] of realms) {
         console.log(
           name.padEnd(col1) + '  ' +
-          statusColor(realm.status.padEnd(col2)) + '  ' +
           chalk.dim(realm.dir)
         );
       }

package/src/commands/new.js

@@ -22,9 +22,7 @@ export function newCommand(program) {
 
       addRealm(registry, name, {
         dir,
-        status: 'active',
         created: new Date().toISOString(),
-        sealed_at: null,
         description: '',
       });
 

package/src/commands/seal.js

@@ -1,16 +0,0 @@
-import { readRegistry, requireRealm, updateRealm } from '../registry.js';
-
-export function sealCommand(program) {
-  program
-    .command('seal <name>')
-    .description('Seal a realm (mark as done)')
-    .action((name) => {
-      const registry = readRegistry();
-      requireRealm(registry, name);
-      updateRealm(registry, name, {
-        status: 'sealed',
-        sealed_at: new Date().toISOString(),
-      });
-      console.log(`✓ Realm "${name}" sealed.`);
-    });
-}

package/src/commands/unseal.js

@@ -1,16 +0,0 @@
-import { readRegistry, requireRealm, updateRealm } from '../registry.js';
-
-export function unsealCommand(program) {
-  program
-    .command('unseal <name>')
-    .description('Unseal a realm (reactivate)')
-    .action((name) => {
-      const registry = readRegistry();
-      requireRealm(registry, name);
-      updateRealm(registry, name, {
-        status: 'active',
-        sealed_at: null,
-      });
-      console.log(`✓ Realm "${name}" unsealed.`);
-    });
-}