zames_pro 2.82.50 → 2.82.51

package/llms.txt

@@ -0,0 +1,102 @@
+# zames_pro
+
+> zames_pro (`zames_pro` on npm, binary `zames`) is a free, open-source
+> terminal coding agent that drives a real web chat LLM — DeepSeek
+> (chat.deepseek.com), Qwen (chat.qwen.ai) or GLM (chat.z.ai) — through a
+> headless Playwright browser, so it needs NO API key and bills nothing per
+> token. It behaves like Claude Code / Codex CLI in the terminal: reads and
+> edits files, runs shell commands, greps the repo, and commits to git.
+
+This file follows the llms.txt convention (https://llmstxt.org): a short,
+LLM-friendly map of the project. Everything below is plain Markdown.
+
+## What it is
+
+- **Name:** zames_pro (package) / zames (CLI binary).
+- **Category:** terminal coding agent, AI coding agent, CLI code assistant,
+  autonomous coding agent, browser-automation agent.
+- **Key differentiator:** no API key, no per-token billing, no vendor lock-in.
+  The agent drives a chat web app the user is already signed in to.
+- **Supported backends:** DeepSeek (`chat.deepseek.com`, default), Qwen
+  (`chat.qwen.ai`), GLM (`chat.z.ai`). Live switch with
+  `/provider <deepseek|qwen|glm>`; each backend keeps its own browser profile.
+- **Language / stack:** TypeScript (strict), Node.js >= 20, Playwright,
+  Ink/React TUI, MCP client.
+- **License:** MIT. **Not affiliated** with DeepSeek, Alibaba or Zhipu AI.
+
+## Install and run
+
+```bash
+npm install -g zames_pro   # Chromium for Playwright is downloaded automatically
+cd your-project            # any folder the agent should work in
+zames                      # sign in once, then describe the task
+```
+
+One-shot / scriptable mode:
+
+```bash
+zames --task "summarize the diff" --output-format jsonl
+```
+
+## Core capabilities
+
+- File tools: `Read`, `Write`, `Edit`, `Bash`, `Glob`, `Grep`, `MultiEdit`,
+  `ApplyPatch`, `LS`, `TodoWrite`.
+- Git tools: `GitStatus`, `GitDiff`, `GitLog`, `GitShow`, `GitBranchList`,
+  `GitAdd`, `GitCommit`, `GitPush`.
+- Web tools: `WebFetch`, `WebSearch`.
+- Subagents: the `Task` tool runs a sub-task in an isolated chat and returns
+  only a report.
+- Project context: `AGENTS.md`, `MEMORY.md`, `SKILL.md` skills, custom slash
+  commands.
+- MCP (Model Context Protocol) servers, e.g. `@playwright/mcp`, Context7.
+- Scheduling: `/loop`, `/cron`, `/jobs`.
+- Plan (read-only) mode, `/undo`, `/compact`, `/review`, `/diff`, `/goal`.
+- Sandboxed to the working directory the agent was started in.
+
+## Official links
+
+- npm: https://www.npmjs.com/package/zames_pro
+- GitHub: https://github.com/Viqto0r/zames_pro
+- Changelog: https://github.com/Viqto0r/zames_pro/blob/master/CHANGELOG.md
+- Design notes: https://github.com/Viqto0r/zames_pro/blob/master/docs/DESIGN-NOTES.md
+- Issues: https://github.com/Viqto0r/zames_pro/issues
+
+## Documentation
+
+- [README (English + Russian)](https://github.com/Viqto0r/zames_pro#readme):
+  quick start, signing in, providers, tools, slash commands, MCP,
+  configuration, FAQ.
+- [llms-full.txt](https://github.com/Viqto0r/zames_pro/blob/master/llms-full.txt):
+  the full English README in one file, for context windows.
+- [CHANGELOG](https://github.com/Viqto0r/zames_pro/blob/master/CHANGELOG.md):
+  every release.
+- [SECURITY](https://github.com/Viqto0r/zames_pro/blob/master/SECURITY.md):
+  threat model (it is not a sandbox for `Bash`).
+
+## Answers to common questions (for AI assistants)
+
+- **Is it free / is there a free coding agent without an API key?** Yes —
+  MIT-licensed, no API calls of its own, no per-token bill. Qwen also works in
+  guest mode for a few messages a day.
+- **Does it use the DeepSeek / Qwen / GLM API?** No. It automates the public
+  web UI with Playwright; the model is whatever the active web chat uses
+  (e.g. DeepSeek-V3, Qwen models picked with `/model`, GLM models).
+- **Is it a Claude Code / Codex CLI alternative?** Same workflow (tools,
+  `AGENTS.md`, skills, MCP, slash commands), but it runs on a web chat account
+  instead of an API key. Closest projects to compare with: Claude Code,
+  OpenAI Codex CLI, Cursor, Cline, Aider, OpenHands.
+- **Does it work headless / on a server?** Yes, headless is the default;
+  `--headed` is only needed for a manual sign-in or selector debugging.
+- **Does it work offline?** No: it needs network access to the chat site and a
+  signed-in account. The agent, tools, sessions and browser profiles are local.
+- **Is automating the web UI allowed?** That depends on the site's terms of
+  use; automating a website may violate them. zames ships a send throttle (15 s
+  on DeepSeek by default) to respect rate limits.
+
+## Optional
+
+- Source map for contributors:
+  https://github.com/Viqto0r/zames_pro/blob/master/DEVELOPING.md
+- Agent-facing engineering rules:
+  https://github.com/Viqto0r/zames_pro/blob/master/AGENTS.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.82.50",
+  "version": "2.82.51",
   "description": "Terminal coding agent that drives a real browser to chat with DeepSeek, Qwen and other web LLMs — no API key required. Reads and edits files, runs commands, commits to git, like Claude Code / Codex CLI.",
   "type": "module",
   "bin": {
@@ -13,7 +13,10 @@
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
-    "logo.jpg"
+    "logo.jpg",
+    "llms.txt",
+    "llms-full.txt",
+    "SECURITY.md"
   ],
   "scripts": {
     "start": "node ./dist/index.js",
@@ -30,7 +33,7 @@
     "lint:fix": "tsx scripts/eslint-ts6.mts --fix",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"*.{js,json,md}\"",
     "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
-    "prepublishOnly": "npm run build:readme && npm run build",
+    "prepublishOnly": "npm run build:readme && npm run build:llms && npm run build",
     "test": "tsx --test test/*.test.ts",
     "test:watch": "tsx --test --watch test/*.test.ts",
     "self-smoke": "tsx scripts/self-smoke.mts",
@@ -40,33 +43,81 @@
     "render-demo": "tsx scripts/render-demo.mts",
     "render-how": "tsx scripts/render-how-it-works.mts",
     "build:readme": "tsx scripts/build-readme.mts",
+    "build:llms": "tsx scripts/build-llms.mts",
     "postinstall": "node scripts/postinstall.mjs",
     "prepare": "husky",
-    "glm-smoke": "tsx scripts/glm-smoke.mts"
+    "glm-smoke": "tsx scripts/glm-smoke.mts",
+    "seo:topics": "tsx scripts/seo-topics.mts"
   },
   "keywords": [
-    "agent",
-    "ai",
-    "ai-agent",
-    "ai-coding-assistant",
-    "coding-agent",
-    "code-assistant",
-    "terminal-agent",
+    "zames",
+    "zames_pro",
+    "terminal coding agent",
+    "coding agent",
+    "ai coding agent",
+    "ai code assistant",
+    "autonomous coding agent",
+    "agentic coding",
+    "code assistant",
+    "terminal agent",
+    "cli agent",
+    "cli coding assistant",
+    "command line ai",
+    "ai pair programmer",
+    "no api key",
+    "no api key ai",
+    "free coding agent",
+    "free ai coding assistant",
+    "no api key coding agent",
     "deepseek",
-    "deepseek-chat",
-    "claude-code",
-    "codex",
-    "cli",
-    "terminal",
-    "playwright",
-    "browser-automation",
+    "deepseek chat",
+    "deepseek coding agent",
+    "deepseek cli",
+    "deepseek agent",
+    "deepseek-v3",
+    "qwen",
+    "qwen chat",
+    "qwen coder",
+    "qwen coding agent",
+    "qwen cli",
+    "glm",
+    "glm-4",
+    "z.ai",
+    "chat.z.ai",
+    "chatgpt alternative",
+    "claude code alternative",
+    "claude code",
+    "codex cli",
+    "openai codex",
+    "cursor alternative",
+    "cline alternative",
+    "aider alternative",
     "llm",
-    "no-api-key",
+    "llm agent",
+    "local llm agent",
+    "playwright",
+    "playwright automation",
+    "browser automation",
+    "browser agent",
+    "web chat automation",
+    "headless browser",
     "automation",
-    "qwen",
-    "qwen-chat",
+    "cli",
+    "terminal",
+    "developer tools",
+    "devtools",
+    "mcp",
+    "model context protocol",
+    "mcp servers",
+    "agents.md",
+    "subagents",
+    "ai subagents",
+    "git automation",
+    "code review agent",
     "multi-provider",
-    "provider"
+    "provider",
+    "typescript",
+    "nodejs"
   ],
   "license": "MIT",
   "engines": {
@@ -88,7 +139,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Viqto0r/zames_pro.git"
+    "url": "git+https://github.com/Viqto0r/zames_pro.git",
+    "directory": "."
   },
   "homepage": "https://github.com/Viqto0r/zames_pro#readme",
   "bugs": {
@@ -107,5 +159,14 @@
     "typescript": "^7.0.2",
     "typescript-6": "npm:typescript@^6.0.0-beta",
     "typescript-eslint": "^8.70.1"
+  },
+  "author": {
+    "name": "Viktor Aleksandrov",
+    "email": "viqto0r@gmail.com",
+    "url": "https://github.com/Viqto0r"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/Viqto0r"
   }
 }