@mithran-hq/aegis 0.9.4 → 0.9.5

package/LICENSE

@@ -0,0 +1,18 @@
+Apache License
+Version 2.0, January 2004
+https://www.apache.org/licenses/
+
+Copyright 2026 Mithran
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+

package/README.md

@@ -0,0 +1,136 @@
+# Aegis
+
+Aegis is the Mithran CLI for account authentication, agent gateway
+configuration, and Forge deploys. This package is the npm launcher; it runs the
+native `aegis` binary from the matching `@mithran-hq/aegis-darwin-arm64` package.
+
+## Requirements
+
+- macOS 15 or later
+- Apple silicon (arm64)
+- Node.js and npm
+
+The launcher refuses unsupported platforms and macOS versions before it starts
+the native binary.
+
+## Install
+
+Prerelease builds are published under the npm dist-tag `next`:
+
+```bash
+npm install -g @mithran-hq/aegis@next
+```
+
+The release flow writes the `next` tag and preserves an existing `latest` tag;
+it does not promote `latest`. Install a pinned version when you need a fixed
+build:
+
+```bash
+npm install -g @mithran-hq/aegis@0.9.5
+```
+
+Check the installed version:
+
+```bash
+aegis version
+```
+
+## Sign in
+
+```bash
+aegis auth login
+aegis auth status
+```
+
+`aegis auth login` opens the browser for sign-in and always prints the sign-in
+URL. Pass `--no-browser` to skip the browser launch and open that URL yourself.
+Sign out with `aegis auth logout`.
+
+## Gateway
+
+Enable, inspect, or disable the gateway for one supported agent:
+
+```bash
+aegis gateway enable --agent claude
+aegis gateway status --agent claude
+aegis gateway disable --agent claude
+```
+
+Supported agents are `claude` and `codex`. Gateway commands require a bound
+account; run `aegis auth login` first.
+
+## Forge
+
+Initialize a Forge app in the current directory, then commit and push it before
+deploying the committed source:
+
+```bash
+mkdir my-app
+cd my-app
+aegis forge init
+git init
+git add mithran.yaml index.html
+git commit -m "Initialize app"
+git remote add origin git@github.com:<owner>/<repo>.git
+git push -u origin HEAD
+aegis forge deploy
+```
+
+`aegis forge init` writes `mithran.yaml` and `index.html`. `aegis forge deploy`
+resolves the committed source from the Git origin and `HEAD`; pass
+`--repo <owner>/<repo>` when the origin is not a GitHub repository, and pass
+`--ref` or `--sha` to select another committed source. Deploy requires a bound
+account.
+
+## Managed Forge skill
+
+A normal global user install also installs the `aegis-forge` instruction skill
+for Claude and Codex:
+
+- `~/.claude/skills/aegis-forge/SKILL.md`
+- `~/.agents/skills/aegis-forge/SKILL.md`
+
+Automatic installation runs only for a normal global user installation. It
+skips when npm runs as root or through sudo, under CI, from a local or
+dependency install, or through npx. A skip is reported and changes no files;
+run `aegis skills install` to install explicitly.
+
+If npm installs with scripts disabled, install the skill afterwards:
+
+```bash
+aegis skills install
+```
+
+Check the installed state with `aegis skills status`. Existing files Aegis does
+not own, changed Aegis-owned files and unexpected entries are preserved and
+reported; unsafe paths are not followed. Automatic installation uses the
+standard OS-account homes. A custom agent home is selected only by an explicit
+`aegis skills install --agent-home <path>`.
+
+npm has no uninstall hook, so remove the skill before removing the CLI:
+
+```bash
+aegis skills remove
+npm uninstall -g @mithran-hq/aegis
+```
+
+The skill explains `forge init` and deploying committed source. Installing it
+grants no deployment authority: authentication, operator decisions and
+point-of-use authorization still apply.
+
+## Documentation
+
+User and developer documentation: https://mithran.ai/docs
+
+## Uninstall
+
+```bash
+npm uninstall -g @mithran-hq/aegis
+```
+
+## Support and security
+
+Questions and bug reports: https://github.com/mithran-hq/aegis/issues
+
+Security policy: https://github.com/mithran-hq/aegis/blob/main/SECURITY.md
+Do not include live credentials in a report.

package/package.json

@@ -2,19 +2,43 @@
   "bin": {
     "aegis": "aegis.mjs"
   },
+  "bugs": {
+    "url": "https://github.com/mithran-hq/aegis/issues"
+  },
   "cpu": [
     "arm64"
   ],
+  "description": "Aegis auth, gateway, and Forge CLI for macOS 15+ Apple silicon",
   "files": [
     "package.json",
-    "aegis.mjs"
+    "aegis.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "homepage": "https://mithran.ai/docs",
+  "keywords": [
+    "aegis",
+    "auth",
+    "gateway",
+    "forge",
+    "cli",
+    "macos",
+    "arm64"
   ],
+  "license": "Apache-2.0",
   "name": "@mithran-hq/aegis",
   "optionalDependencies": {
-    "@mithran-hq/aegis-darwin-arm64": "0.9.4"
+    "@mithran-hq/aegis-darwin-arm64": "0.9.5"
   },
   "os": [
     "darwin"
   ],
-  "version": "0.9.4"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mithran-hq/aegis.git"
+  },
+  "scripts": {
+    "postinstall": "node aegis.mjs skills install --npm-postinstall"
+  },
+  "version": "0.9.5"
 }