xkat-cli 1.1.2 → 1.1.4

package/README.md

@@ -1,20 +1,20 @@
-# xKat (Local Terminal Bridge)
+# xKat Agent
 
-xKat Agent is a bridge tool that securely connects a browser-based coding
-learning platform to your local environment.
+xKat Agent is an AI agent for your machine. It securely connects your browser
+to your local environment, turning the power of your computer into capabilities
+the web experience can use.
 
 ## Features
 
 - **Zero-install local shell bridge**: Connects the web IDE terminal in your
   browser directly to your local shell. A single `npx xkat up` spawns a native
   shell (PTY) with your current user permissions — no extra install or setup.
+- **Extensible agent**: Designed to grow beyond the terminal, bridging more
+  local capabilities over the same secure channel over time.
 - **Real-time file sync**: Watches file changes (VFS) in your local working
   directory and syncs them with the web dashboard instantly.
 - **Security-first design**: Binds to the 127.0.0.1 loopback and verifies the
   request Origin to keep local control safe.
-- **(Optional) SSH mode**: If you provide credentials (user/password), it can
-  connect to a local SSH server instead. The default is the zero-install
-  direct shell.
 
 ## Getting started
 
@@ -24,6 +24,17 @@ Run instantly via npm without a separate install:
 npx xkat up
 ```
 
+`up` starts the agent in the background and returns immediately, so your
+terminal stays free. Manage it with:
+
+```bash
+xkat up       # start the agent in the background (alias: start)
+xkat down     # stop the background agent          (alias: stop)
+xkat status   # show whether the agent is running
+```
+
+Logs are written to `~/.xkat/agent.log`.
+
 Or install globally:
 
 ```bash
@@ -34,8 +45,6 @@ xkat up
 ## System requirements
 
 - **Node.js**: 16.x or newer.
-- **OpenSSH Server (optional)**: Not needed for the default zero-install shell
-  mode. Only required when using the SSH credentials mode.
 
 ## Security guidelines
 
@@ -55,9 +64,11 @@ See `docs/xkat-agent/deployment-pipeline.md` and
 ```bash
 cd apps/xkat-agent
 npm version patch --no-git-tag-version
-git add package.json && git commit -m "chore(agent): release vX.Y.Z"
+git add package.json
+git commit -m "chore(agent): release v$(node -p "require('./package.json').version")"
+git push origin main
 git tag agent-v$(node -p "require('./package.json').version")
-git push origin main --tags
+git push origin agent-v$(node -p "require('./package.json').version")
 ```
 
 ## License

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "xkat-cli",
-  "version": "1.1.2",
-  "description": "xKat Local Terminal Agent - Bridge between Web IDE and Local Shell",
+  "version": "1.1.4",
+  "description": "xKat Agent - an AI agent that securely connects your browser to your machine",
   "main": "bin/xkat-cli.js",
   "bin": {
     "xkat": "bin/xkat-cli.js"
@@ -14,21 +14,14 @@
   "scripts": {
     "postinstall": "node ./scripts/install.js"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/somilab/xkat-agent.git"
-  },
   "keywords": [
     "xkat",
-    "terminal",
-    "ssh",
-    "bridge",
-    "agent"
+    "ai-agent",
+    "agent",
+    "local",
+    "bridge"
   ],
   "author": "SomiLab <contact@somilab.com>",
   "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/somilab/xkat-agent/issues"
-  },
   "homepage": "https://xkat.space"
 }