imagera-code 1.19.5 → 1.19.6

package/README.md

@@ -1,13 +1,82 @@
 # Imagera Code
 
-A coding agent for your terminal, running on Imagera.
+A coding agent for your terminal, running on Imagera. It reads your project, edits files, runs your tests and shows you the diff, on models from Anthropic, OpenAI, Google, xAI, DeepSeek, Qwen, Zhipu and more, switchable mid-session.
 
 ```sh
 npm i -g imagera-code
-imagera-code login
-imagera-code
+imagera-code login        # approve in the browser
+imagera-code              # start in any project
 ```
 
+## What it does
+
+- **Fix, build, refactor, migrate.** Describe the change; it edits the files and runs your tests until they pass.
+- **Any model.** `/models` switches model mid-session; `-m imagera/<model>` picks one for a run.
+- **Plan first.** `/plan` (or `--agent plan`) writes a plan without touching files.
+- **Review before you push.** `/review` reviews your uncommitted changes, a branch or a commit; `/security-review` looks for injection, leaked secrets and missing auth checks.
+- **Goals, not steps.** `/goal <condition>` keeps working until the condition is true.
+- **Subagents.** Ask for several things at once and it runs them in parallel, each in its own context.
+- **Images.** Attach a screenshot or diagram: `imagera-code run "what is wrong here?" -f screenshot.png`.
+- **MCP servers.** Add tools in `~/.config/imagera-code/opencode.jsonc` under `"mcp"`; `imagera-code mcp list` shows them.
+- **Hooks.** A plugin in `.opencode/plugin/*.ts` can check or block tool calls, for example:
+
+  ```ts
+  export const Guard = async () => ({
+    "tool.execute.before": async (input, output) => {
+      if (input.tool === "bash" && /rm\s+-rf/.test(output.args.command ?? "")) throw new Error("Blocked by project policy")
+    },
+  })
+  ```
+- **Usage at a glance.** `/usage` (or `imagera-code status`) shows your plan and its short and weekly limits.
+
+## Scripts and CI
+
+```sh
+imagera-code run "fix the failing test"                  # one task, then exit
+imagera-code run --format json "…"                       # machine-readable events
+imagera-code setup-token                                 # a one-year key for CI (prints it; saves nothing)
+echo "$KEY" | imagera-code login --with-api-key          # or set IMAGERA_API_KEY
+```
+
+### Review every pull request on GitHub
+
+Save the key from `imagera-code setup-token` as the repository secret `IMAGERA_API_KEY`, then add `.github/workflows/imagera-code-review.yml`:
+
+```yaml
+# Imagera Code reviews every pull request and posts the review as a comment.
+# Setup: run `imagera-code setup-token` once and save the printed key as the repository secret IMAGERA_API_KEY.
+name: Imagera Code review
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+permissions:
+  contents: read
+  pull-requests: write
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - uses: actions/setup-node@v4
+        with: { node-version: '22' }
+      - run: npm i -g imagera-code
+      - name: Review the changes in this pull request
+        env:
+          IMAGERA_API_KEY: ${{ secrets.IMAGERA_API_KEY }}
+          BASE: origin/${{ github.event.pull_request.base.ref }}
+        run: |
+          imagera-code run --command review "$BASE" < /dev/null > review.md
+          cat review.md
+      - name: Post the review on the pull request
+        env: { GH_TOKEN: '${{ github.token }}' }
+        run: gh pr comment ${{ github.event.pull_request.number }} --body-file review.md
+```
+
+## Privacy
+
+When something breaks, the app sends a short report (error kind and message with paths, emails and keys removed, app version, OS, model) to Imagera. Never your code, prompts or files. Turn it off with `IMAGERA_TELEMETRY=0`.
+
 Plans and usage: https://imagera.ai/code · Terms: https://imagera.ai/terms · Support: https://imagera.ai/support
 
 Based on OpenCode (MIT). See LICENSE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imagera-code",
-  "version": "1.19.5",
+  "version": "1.19.6",
   "license": "MIT",
   "homepage": "https://imagera.ai/code",
   "description": "Imagera Code: a coding agent for your terminal.",
@@ -17,17 +17,17 @@
     "x64"
   ],
   "optionalDependencies": {
-    "imagera-code-windows-x64-baseline": "1.19.5",
-    "imagera-code-linux-x64-baseline": "1.19.5",
-    "imagera-code-linux-x64-musl": "1.19.5",
-    "imagera-code-linux-arm64-musl": "1.19.5",
-    "imagera-code-darwin-arm64": "1.19.5",
-    "imagera-code-windows-arm64": "1.19.5",
-    "imagera-code-darwin-x64-baseline": "1.19.5",
-    "imagera-code-linux-arm64": "1.19.5",
-    "imagera-code-linux-x64-baseline-musl": "1.19.5",
-    "imagera-code-darwin-x64": "1.19.5",
-    "imagera-code-linux-x64": "1.19.5",
-    "imagera-code-windows-x64": "1.19.5"
+    "imagera-code-windows-x64-baseline": "1.19.6",
+    "imagera-code-linux-x64-baseline": "1.19.6",
+    "imagera-code-linux-x64-musl": "1.19.6",
+    "imagera-code-linux-arm64-musl": "1.19.6",
+    "imagera-code-darwin-arm64": "1.19.6",
+    "imagera-code-windows-arm64": "1.19.6",
+    "imagera-code-darwin-x64-baseline": "1.19.6",
+    "imagera-code-linux-arm64": "1.19.6",
+    "imagera-code-linux-x64-baseline-musl": "1.19.6",
+    "imagera-code-darwin-x64": "1.19.6",
+    "imagera-code-linux-x64": "1.19.6",
+    "imagera-code-windows-x64": "1.19.6"
   }
 }