agents-toolchain 0.1.3__py3-none-win_amd64.whl

agents_toolchain/__init__.py

@@ -0,0 +1 @@
+"""Agents Toolchain's bundled native CLI."""

agents_toolchain/__main__.py

@@ -0,0 +1,3 @@
+from ._cli import main
+
+raise SystemExit(main())

agents_toolchain/_cli.py

@@ -0,0 +1,27 @@
+"""Run the bundled executable without changing its arguments or environment."""
+
+import os
+from pathlib import Path
+import subprocess
+import sys
+
+
+def main():
+    binary = Path(__file__).parent / "bin" / ("atc.exe" if os.name == "nt" else "atc")
+    if not binary.is_file():
+        print("atc: bundled binary is missing; reinstall agents-toolchain with pip.", file=sys.stderr)
+        return 1
+    args = [str(binary), *sys.argv[1:]]
+    try:
+        if os.name != "nt":
+            os.execv(str(binary), args)
+        child = subprocess.Popen(args)
+        while True:
+            try:
+                return child.wait()
+            except KeyboardInterrupt:
+                # Windows sends console Ctrl+C to both processes. Let the CLI exit.
+                continue
+    except OSError as error:
+        print("atc: could not start bundled binary: {}".format(error), file=sys.stderr)
+        return 1

agents_toolchain-0.1.3.dist-info/METADATA

@@ -0,0 +1,290 @@
+Metadata-Version: 2.4
+Name: agents-toolchain
+Version: 0.1.3
+Summary: CLI for creating and running YAML-configured AI agents
+Author: Deahesi
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Project-URL: Source, https://github.com/Deahesi/agents-toolchain
+Description-Content-Type: text/markdown
+
+# Agents Toolchain (atc)
+
+## Overview
+
+A CLI for creating and running AI agents. Define an agent's task, model, and tools in YAML, then run it from the terminal. Agents can read project files, write documentation and tests, or review code.
+
+## Installation
+
+All release packages contain a ready-to-run Go binary. The command is always `atc`.
+
+### npm (Windows, Linux, macOS)
+
+Requires Node.js 22 or later. Install globally:
+
+```sh
+npm install -g @deahesi/agents-toolchain
+atc --help
+atc --version
+```
+
+Or run it without a global installation:
+
+```sh
+npx @deahesi/agents-toolchain --help
+npx @deahesi/agents-toolchain init
+```
+
+The npm package includes a launcher and installs the native binary for Windows, Linux, or macOS on x64 or ARM64. Go is not required. Installation also works with `--ignore-scripts`; keep optional dependencies enabled so npm can install the platform package. An unsupported platform or a missing platform package produces an error with installation guidance. The command is `atc` for both local and global installations.
+
+### Homebrew (macOS, Linux)
+
+```sh
+brew install --cask Deahesi/tap/agents-toolchain
+atc --help
+```
+
+The cask selects the x64 or ARM64 archive from GitHub Releases. It requires neither Go nor Node.js. Updates use `brew upgrade --cask agents-toolchain`.
+
+### pip (Windows, Linux, macOS)
+
+Requires Python 3.10 or later. Install in your Python virtual environment:
+
+```sh
+python -m pip install agents-toolchain
+atc --help
+python -m agents_toolchain --version
+```
+
+Platform wheels include the native binary; installation does not compile Go or download executables from GitHub. Wheels cover x64 and ARM64 on Windows, macOS 12+, and Linux with glibc or musl. There is no source distribution that would require a Go compiler. Keep your virtual environment activated to use its `atc` command.
+
+### Debian / Ubuntu and RPM distributions
+
+Download the package for your architecture from [GitHub Releases](https://github.com/Deahesi/agents-toolchain/releases). For example, for version `0.1.2` on x64:
+
+```sh
+# Debian / Ubuntu
+sudo apt install ./agents-toolchain_0.1.2_amd64.deb
+
+# Fedora / RHEL family
+sudo dnf install ./agents-toolchain-0.1.2-1.x86_64.rpm
+
+atc --help
+```
+
+ARM64 packages end in `_arm64.deb` and `.aarch64.rpm`. Packages install `/usr/bin/atc`, the README, and the MIT license. These are downloadable packages, not an APT or YUM repository.
+
+### From source
+
+Alternatively, build from source with Go 1.26.5 or later:
+
+```powershell
+go install github.com/Deahesi/agents-toolchain/cmd/atc@latest
+```
+
+Make sure the installation directory is in `PATH`. Go uses `GOBIN` if set, otherwise `GOPATH/bin` (usually `%USERPROFILE%\go\bin` on Windows). `go install` does not update `PATH`; after adding the directory, open a new terminal.
+
+## Base usage
+
+Run the following steps from the project directory you want the agent to work on.
+
+1. Create a `.env` file with your provider's API key:
+
+   ```dotenv
+   OPENAI_API_KEY=your-api-key
+   ```
+
+2. Initialize the project and create an agent:
+
+   ```powershell
+   atc init
+   atc add hello
+   ```
+
+   Skip `init` if `agents-toolchain.yml` already exists. The `add` command asks for the agent's settings and saves them to `agents/hello/agent.yml`.
+
+3. Run the agent:
+
+   ```powershell
+   atc run hello --prompt "Hello!"
+   ```
+
+Use `--prompt` or `-p` to provide a request. Without it, the agent follows the task in `system_prompt`.
+
+Use `atc init --agents-dir <directory>` to choose where agent configs are stored. All commands accept `--workspace-dir <directory>` to choose the project containing `agents-toolchain.yml`. File tools and `.env` still use the current working directory, so launch the CLI from the project you want the agent to work on.
+
+## Config
+
+`agents-toolchain.yml` specifies the directory containing agents:
+
+```yaml
+agents_dir: agents
+```
+
+Each agent has a config at `agents/<name>/agent.yml`:
+
+```yaml
+version: "1.0"
+agent:
+  name: hello
+  description: My first agent
+  provider: openai
+  model: gpt-4o
+  temperature: 0.2
+  system_prompt: |
+    You are a helpful assistant. Answer clearly and to the point.
+  tools: []
+```
+
+- `name` must match the agent directory name.
+- `description` briefly describes the agent.
+- `provider` is `openai`, `anthropic`, `ollama`, or `openrouter`.
+- `model` is the model ID for that provider, without adding the provider prefix.
+- `temperature` ranges from `0` to `2`; lower values give more predictable responses.
+- `system_prompt` describes the agent's task and expected output.
+- `tools` lists the tools the agent can use. Leave it empty for text-only tasks.
+
+Built-in tools use `type: builtin`. Available names are `list_files`, `search_files`, `read_file`, `write_file`, `edit_file`, `execute_command`, `get_environment`, and `get_datetime`.
+
+The CLI automatically reads `.env` from the current working directory at startup. Existing environment variables take priority. The file is optional if the variables are already set; `--workspace-dir` does not change where `.env` is read.
+
+| Provider | Environment variables |
+| --- | --- |
+| `openai` | `OPENAI_API_KEY`; optional `OPENAI_BASE_URL` |
+| `anthropic` | `ANTHROPIC_API_KEY` or `ANTHROPIC_AUTH_TOKEN` |
+| `openrouter` | `OPENROUTER_API_KEY` |
+| `ollama` | Optional `OLLAMA_HOST`, defaults to `http://localhost:11434` |
+
+## Examples
+
+Save each config at the path shown. You can create the folder and file manually or use `atc add <name>` and replace the generated config. These examples use OpenAI; set `OPENAI_API_KEY` in `.env` and choose a model that supports tools.
+
+### Documentation from project files
+
+`agents/docs/agent.yml`:
+
+```yaml
+version: "1.0"
+agent:
+  name: docs
+  description: Write documentation from local project files
+  provider: openai
+  model: gpt-4o
+  temperature: 0.2
+  system_prompt: |
+    Read the local project, starting from the current directory.
+    Explore relevant subdirectories and inspect source files, configs,
+    and existing documentation. Write or update README.md with a simple
+    overview, setup steps, configuration, and usage examples.
+    Describe only behavior supported by the files you read.
+    Keep the project's documentation language and style.
+    Change only documentation files. End with a brief list of changes.
+  tools:
+    - type: builtin
+      name: list_files
+    - type: builtin
+      name: read_file
+    - type: builtin
+      name: write_file
+    - type: builtin
+      name: edit_file
+```
+
+```powershell
+atc run docs
+```
+
+### Automated tests from a local project
+
+`agents/tests/agent.yml`:
+
+```yaml
+version: "1.0"
+agent:
+  name: tests
+  description: Write and run tests for the local project
+  provider: openai
+  model: gpt-4o
+  temperature: 0.2
+  system_prompt: |
+    Read the local project, starting from the current directory.
+    Explore relevant subdirectories, source files, existing tests,
+    and test configuration. Use the project's test framework and style.
+    Add meaningful tests for normal behavior, edge cases, and errors.
+    Change only test files. Run the relevant tests with execute_command.
+    End with a brief list of added tests and their results.
+    If tests could not be run, say so and explain why.
+  tools:
+    - type: builtin
+      name: list_files
+    - type: builtin
+      name: read_file
+    - type: builtin
+      name: write_file
+    - type: builtin
+      name: edit_file
+    - type: builtin
+      name: execute_command
+```
+
+```powershell
+atc run tests
+```
+
+### Project review with structured findings
+
+`agents/review/agent.yml`:
+
+```yaml
+version: "1.0"
+agent:
+  name: review
+  description: Review the local project and report problems
+  provider: openai
+  model: gpt-4o
+  temperature: 0.2
+  system_prompt: |
+    Review the local project, starting from the current directory.
+    Explore relevant subdirectories and read source files, configs,
+    and tests. Look for bugs, security issues, and incorrect behavior.
+    Report only problems supported by the files you read.
+    Do not modify files.
+    In your final response, report each problem as a separate block:
+    file: <relative file path>
+    row: <line number or range, starting at 1>
+    problem: <what is wrong and its impact>
+    Separate blocks with a blank line. Do not wrap them in Markdown fences.
+    If problems were found, the final line must be exactly:
+    Status: error
+    If no problems were found after completing the review, output only:
+    Status: success
+    If the review could not be completed, report the blocker using the
+    same block format, use row: N/A when needed, and end with Status: error.
+    Do not output anything after the status line.
+  tools:
+    - type: builtin
+      name: list_files
+    - type: builtin
+      name: read_file
+```
+
+```powershell
+atc run review
+```
+
+Example final response when a problem is found:
+
+```text
+file: src/config.go
+row: 42
+problem: An empty API key is accepted, causing requests to fail later.
+
+Status: error
+```
+
+With no problems:
+
+```text
+Status: success
+```

agents_toolchain-0.1.3.dist-info/RECORD

@@ -0,0 +1,9 @@
+agents_toolchain-0.1.3.dist-info/METADATA,sha256=Ib8ja1_YPo5o-MugoCfyrkvsb5lOXytcwmUOSNNEUIM,9308
+agents_toolchain-0.1.3.dist-info/WHEEL,sha256=Oq3LM_dVSQqbT1eJqfaFAtPYenrmmPcSgvVASSA-DqE,105
+agents_toolchain-0.1.3.dist-info/entry_points.txt,sha256=heKUbNQ51ojp1DRUIX8ufWXvypZAACxnZoq60yYx4VY,51
+agents_toolchain-0.1.3.dist-info/licenses/LICENSE,sha256=zv7ELTk_KDbjyFP8uyYkokn_t9U_9zuC6EtIi__stAk,1063
+agents_toolchain/__init__.py,sha256=_VgkCIdbojWvKo5lmSFNnbUA_WMXbqtVSHoUZfZ3Hww,45
+agents_toolchain/__main__.py,sha256=g-q3cJEP2vv6Ppov3S-YHp3sJsGGZH4v3gYvvwdFOxg,49
+agents_toolchain/_cli.py,sha256=R4iKSftiCe3C8-R2GChwBwOEndNz9I61kBFrHcCHal8,905
+agents_toolchain/bin/atc.exe,sha256=-HV0dMyq-MbaI6qydhtp37m4Haw5jBvhgz_biBh1izc,28403200
+agents_toolchain-0.1.3.dist-info/RECORD,,

agents_toolchain-0.1.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: agents-toolchain-goreleaser
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64

agents_toolchain-0.1.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+atc = agents_toolchain._cli:main

agents_toolchain-0.1.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deahesi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.