copper-pilot-cli 0.1.1__tar.gz

copper_pilot_cli-0.1.1/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.coverage
+.pytest_cache/
+.ruff_cache/
+.venv/
+dist/
+build/

copper_pilot_cli-0.1.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,131 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail
+address, posting via an official social media account, or acting as an
+appointed representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement. All complaints will be reviewed and investigated promptly
+and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

copper_pilot_cli-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,99 @@
+# Contributing
+
+Thanks for helping improve CopperPilot CLI. By participating you agree to the
+[Code of Conduct](CODE_OF_CONDUCT.md).
+
+This repository is the open-source terminal and LangChain client for the hosted
+CopperPilot agent. It is not the desktop app or the hosted backend.
+
+## Prerequisites
+
+- Python 3.12 or newer
+- [pip](https://pip.pypa.io/en/stable/)
+- [make](https://www.gnu.org/software/make/) (optional; the same commands are
+  listed below)
+- A CopperPilot account only if you run live tests
+- KiCad 10 on `PATH` only for [`examples/001_esp32`](examples/001_esp32)
+
+## Set up a development install
+
+```console
+git clone https://github.com/CopperPilot/copper-pilot-cli.git
+cd copper-pilot-cli
+python3 -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+On Windows, Git Bash or PowerShell both work; `make` is optional.
+
+## Format, lint, and test
+
+```console
+make fmt
+make lint
+make test
+```
+
+Without `make`:
+
+```console
+python -m ruff format src tests examples
+python -m ruff format --check src tests examples
+python -m ruff check src tests examples
+python -m ty check src/copper_pilot_cli
+python -m pytest -m "not live"
+```
+
+`make test` skips tests marked `live`. Live tests exercise device login, the
+Textual composer, the hosted stream, and local-tool round trips. They use the
+normal private credential store and skip when no credential is present:
+
+```console
+copper-pilot auth login
+pytest -m live
+```
+
+Never commit `~/.copper-pilot/.state/auth.json`, API keys, or private boards.
+
+## Pull requests
+
+1. Create a branch from `main`.
+2. Keep the change focused: one bug, feature, or docs fix per PR.
+3. Add or update tests. Coverage of new branches in `src/copper_pilot_cli`
+   (except `_upstream/`) is expected.
+4. Update docs when behavior changes: [README.md](README.md),
+   [docs/cli.md](docs/cli.md), or [docs/development.md](docs/development.md).
+5. Run `make fmt && make lint && make test`.
+6. Open a pull request with the template. Fill in the test plan.
+
+CI runs lint, tests, `pip-audit`, a license check, and a wheel install on
+every pull request.
+
+## Scope of this package
+
+Keep this client a hosted-agent frontend. Do not add:
+
+- Hosted-server or `copper_pilot_core` code
+- Model or provider pickers
+- Local model execution
+- Computer use
+- MCP or plugin controls
+- LangSmith tracing or content telemetry
+- Sandbox runtimes
+
+Upstream Textual presentation is vendored under
+`src/copper_pilot_cli/_upstream/` with provenance in [UPSTREAM.md](UPSTREAM.md)
+and [NOTICE](NOTICE). When porting upstream changes, follow that document;
+do not reintroduce upstream runtime surfaces.
+
+## Reporting issues
+
+Use the [bug report form](https://github.com/CopperPilot/copper-pilot-cli/issues/new?template=bug_report.yml)
+and include steps to reproduce. Security issues go to [SECURITY.md](SECURITY.md),
+not the public tracker.
+
+## Release
+
+Maintainers cut a release with `make release`. See
+[docs/development.md](docs/development.md#release).

copper_pilot_cli-0.1.1/HISTORY.md

@@ -0,0 +1,19 @@
+Changelog
+=========
+
+
+0.1.0 (2026-09-17)
+------------------
+- Release: version 0.1.0 🚀 [AdityaNG]
+- Fix(tests/test_release_gates.py) [AdityaNG]
+- Test. [AdityaNG]
+- Docs. [AdityaNG]
+- Docs. [AdityaNG]
+- Example(examples/001_esp32/) [AdityaNG]
+- Makefile. [AdityaNG]
+- Ci. [AdityaNG]
+- Docs. [AdityaNG]
+- Refactor(name) [AdityaNG]
+- Init. [AdityaNG]
+
+

copper_pilot_cli-0.1.1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 CopperPilot, Inc.
+Copyright (c) LangChain, Inc.
+
+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.

copper_pilot_cli-0.1.1/NOTICE

@@ -0,0 +1,13 @@
+CopperPilot CLI includes modified portions of Deep Agents Code.
+
+Deep Agents Code
+Copyright (c) LangChain, Inc.
+Licensed under the MIT License.
+
+Upstream source:
+https://github.com/langchain-ai/deepagents
+
+Pinned source revision:
+1d3232c0852c47af09119edea10eeec887e4f0da
+
+The LangChain name and trademarks are not used to endorse CopperPilot.

copper_pilot_cli-0.1.1/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.5
+Name: copper-pilot-cli
+Version: 0.1.1
+Summary: CopperPilot hosted agent for the terminal and LangChain
+Project-URL: Homepage, https://copperpilot.ai
+Project-URL: Repository, https://github.com/CopperPilot/copper-pilot-cli
+Project-URL: Issues, https://github.com/CopperPilot/copper-pilot-cli/issues
+Project-URL: Documentation, https://github.com/CopperPilot/copper-pilot-cli#readme
+Project-URL: Changelog, https://github.com/CopperPilot/copper-pilot-cli/releases
+Author: CopperPilot
+License: MIT License
+        
+        Copyright (c) 2026 CopperPilot, Inc.
+        Copyright (c) LangChain, Inc.
+        
+        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.
+License-File: LICENSE
+License-File: NOTICE
+Requires-Python: <4,>=3.12
+Requires-Dist: aiosqlite<1,>=0.22
+Requires-Dist: certifi>=2024.8.30
+Requires-Dist: deepagents==0.7.14
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: langchain-core<2,>=1.6
+Requires-Dist: langgraph-checkpoint-sqlite<4,>=3.1
+Requires-Dist: langgraph<2,>=1.2
+Requires-Dist: markdownify<2,>=1.2
+Requires-Dist: packaging<27,>=25
+Requires-Dist: pillow<13,>=12
+Requires-Dist: pydantic<3,>=2.12
+Requires-Dist: pyperclip<2,>=1.11
+Requires-Dist: pyyaml<7,>=6
+Requires-Dist: rich<16,>=15
+Requires-Dist: textual<9,>=8.2.8
+Requires-Dist: uuid-utils<1,>=0.12
+Requires-Dist: websockets<17,>=15
+Provides-Extra: dev
+Requires-Dist: build<2,>=1.4; extra == 'dev'
+Requires-Dist: gitchangelog==3.0.4; extra == 'dev'
+Requires-Dist: pip-audit<3,>=2.10; extra == 'dev'
+Requires-Dist: pip-licenses<6,>=5; extra == 'dev'
+Requires-Dist: pytest-asyncio<2,>=1.3; extra == 'dev'
+Requires-Dist: pytest-cov<8,>=7; extra == 'dev'
+Requires-Dist: pytest<10,>=9; extra == 'dev'
+Requires-Dist: ruff<1,>=0.14; extra == 'dev'
+Requires-Dist: ty>=0.0.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <a href="https://copperpilot.ai">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/CopperPilot/copper-pilot-cli/blob/main/docs/assets/logo-dark.png?raw=true">
+      <source media="(prefers-color-scheme: light)" srcset="https://github.com/CopperPilot/copper-pilot-cli/blob/main/docs/assets/logo-light.png?raw=true">
+      <img alt="CopperPilot" src="https://github.com/CopperPilot/copper-pilot-cli/blob/main/docs/assets/logo-light.png?raw=true" width="55%">
+    </picture>
+  </a>
+</div>
+
+<div align="center">
+  <h3>The AI for PCB design, in your terminal.</h3>
+</div>
+
+<div align="center">
+  <a href="https://github.com/CopperPilot/copper-pilot-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/copper-pilot-cli" alt="License"></a>
+  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/v/copper-pilot-cli" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/pyversions/copper-pilot-cli" alt="Python"></a>
+  <a href="https://github.com/CopperPilot/copper-pilot-cli/actions/workflows/ci.yml"><img src="https://github.com/CopperPilot/copper-pilot-cli/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+</div>
+
+<div align="center">
+  <a href="https://x.com/copperpilot_ai"><img src="https://img.shields.io/twitter/follow/copperpilot_ai?style=social" alt="Follow on X"></a>
+  <a href="https://www.linkedin.com/company/copperpilot"><img src="https://img.shields.io/badge/LinkedIn-CopperPilot-0A66C2?logo=linkedin&logoColor=white" alt="LinkedIn"></a>
+  <a href="https://www.youtube.com/@CopperPilot"><img src="https://img.shields.io/badge/YouTube-@CopperPilot-FF0000?logo=youtube&logoColor=white" alt="YouTube"></a>
+  <a href="https://www.instagram.com/copperpilot.ai/"><img src="https://img.shields.io/badge/Instagram-copperpilot.ai-E4405F?logo=instagram&logoColor=white" alt="Instagram"></a>
+</div>
+
+<br>
+
+CopperPilot in your terminal: a thin, open-source client for CopperPilot electronics design agent, the best AI for PCB Design.
+
+<p align="center">
+  <img src="https://github.com/CopperPilot/copper-pilot-cli/blob/main/docs/assets/esp32-mini-1-h4.gif?raw=true" alt="CopperPilot building an ESP32-MINI-1 board">
+</p>
+
+## Prerequisites
+
+- Python 3.12 or newer
+- A [CopperPilot](https://copperpilot.ai) account for login
+- KiCad 10 on `PATH` only if you run [`examples/001_esp32`](examples/001_esp32)
+
+## Install and run
+
+```console
+pip install copper-pilot-cli
+copper-pilot
+```
+
+The first interactive launch opens a browser for CopperPilot device login.
+With no path argument, the current directory is the workspace and a new chat
+starts immediately. Any existing directory is valid.
+
+```console
+copper-pilot ./my-board
+copper-pilot --resume
+copper-pilot threads list
+copper-pilot -n -m "Review this board" --json
+```
+
+Both `copper-pilot` and `copper-pilot-cli` run the same program.
+`copper-pilot --help` lists flags; [docs/cli.md](docs/cli.md) is the full
+command reference.
+
+## Configuration
+
+- Production API: `https://copperpilot.ai`
+- Development override: `COPPER_PILOT_API_URL`
+- User state: `~/.copper-pilot/.state`
+- Project artifacts: `.copperpilot/`
+
+Credentials are stored in a private, atomically replaced `auth.json`; on POSIX
+the parent directory is mode `0700` and the file is mode `0600`.
+
+## LangChain
+
+```python
+from copper_pilot_cli.copper_protocol import CopperMode
+from copper_pilot_cli.langchain import CopperPilotAgent
+from helper import drc_violations, erc_errors, render_pcb, run
+
+PLAN = CopperMode.PLAN
+
+copper_pilot = CopperPilotAgent(workspace="esp32")
+
+run(copper_pilot, "Build me an ESP32 dev board.", PLAN)
+run(copper_pilot, "Let us build this plan.")
+run(copper_pilot, "Inspect the PCB, check for any missing 3D models, and apply them accordingly.")
+
+assert erc_errors() == 0
+assert drc_violations() == 0
+render_pcb("esp32.png")
+```
+
+`CopperPilotAgent` is a `Runnable`, not a chat model. It represents a complete
+hosted agent run, including local tool requests. Use `as_langgraph()` for graph
+composition or `as_compiled_subagent()` for explicit delegation from an outer
+Deep Agent. The compatible `deepagents` runtime is installed and pinned by this
+package.
+
+That snippet is the runnable example in
+[`examples/001_esp32`](examples/001_esp32).
+
+## Security boundary
+
+The hosted agent may request local filesystem and shell tools. Reads and
+searches run freely. Writes, edits, deletes, and shell commands are gated by
+Manual approval by default. Auto permits only deterministic routine actions;
+unknown actions still ask. YOLO must be selected explicitly.
+
+Filesystem, search, edit, and shell execution use Deep Agents' native
+`FilesystemMiddleware` tools and `LocalShellBackend`; CopperPilot's adapter only
+normalizes hosted tool names, approval decisions, and result envelopes.
+
+Computer use, model/provider selection, local model execution, LangSmith
+tracing, content telemetry, MCP/plugin controls, and server implementation code
+are not part of this package.
+
+See [UPSTREAM.md](UPSTREAM.md) and [NOTICE](NOTICE) for the retained Textual
+client attribution.
+
+To report a vulnerability, see [SECURITY.md](SECURITY.md).
+
+## Development
+
+```console
+pip install -e ".[dev]"
+make fmt
+make lint
+make test
+```
+
+`make test` runs `pytest -m "not live"`. Live tests skip unless a CopperPilot
+credential is stored. Release tagging is `make release`. Details:
+[docs/development.md](docs/development.md).
+
+## Contributing
+
+Bug reports, features, and pull requests are welcome. Please read
+[CONTRIBUTING.md](CONTRIBUTING.md) and the
+[Code of Conduct](CODE_OF_CONDUCT.md). Use the
+[bug report form](https://github.com/CopperPilot/copper-pilot-cli/issues/new?template=bug_report.yml)
+so we can reproduce the problem.
+
+## License
+
+[MIT](LICENSE).

copper_pilot_cli-0.1.1/README.md

@@ -0,0 +1,147 @@
+<div align="center">
+  <a href="https://copperpilot.ai">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/CopperPilot/copper-pilot-cli/blob/main/docs/assets/logo-dark.png?raw=true">
+      <source media="(prefers-color-scheme: light)" srcset="https://github.com/CopperPilot/copper-pilot-cli/blob/main/docs/assets/logo-light.png?raw=true">
+      <img alt="CopperPilot" src="https://github.com/CopperPilot/copper-pilot-cli/blob/main/docs/assets/logo-light.png?raw=true" width="55%">
+    </picture>
+  </a>
+</div>
+
+<div align="center">
+  <h3>The AI for PCB design, in your terminal.</h3>
+</div>
+
+<div align="center">
+  <a href="https://github.com/CopperPilot/copper-pilot-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/copper-pilot-cli" alt="License"></a>
+  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/v/copper-pilot-cli" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/pyversions/copper-pilot-cli" alt="Python"></a>
+  <a href="https://github.com/CopperPilot/copper-pilot-cli/actions/workflows/ci.yml"><img src="https://github.com/CopperPilot/copper-pilot-cli/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+</div>
+
+<div align="center">
+  <a href="https://x.com/copperpilot_ai"><img src="https://img.shields.io/twitter/follow/copperpilot_ai?style=social" alt="Follow on X"></a>
+  <a href="https://www.linkedin.com/company/copperpilot"><img src="https://img.shields.io/badge/LinkedIn-CopperPilot-0A66C2?logo=linkedin&logoColor=white" alt="LinkedIn"></a>
+  <a href="https://www.youtube.com/@CopperPilot"><img src="https://img.shields.io/badge/YouTube-@CopperPilot-FF0000?logo=youtube&logoColor=white" alt="YouTube"></a>
+  <a href="https://www.instagram.com/copperpilot.ai/"><img src="https://img.shields.io/badge/Instagram-copperpilot.ai-E4405F?logo=instagram&logoColor=white" alt="Instagram"></a>
+</div>
+
+<br>
+
+CopperPilot in your terminal: a thin, open-source client for CopperPilot electronics design agent, the best AI for PCB Design.
+
+<p align="center">
+  <img src="https://github.com/CopperPilot/copper-pilot-cli/blob/main/docs/assets/esp32-mini-1-h4.gif?raw=true" alt="CopperPilot building an ESP32-MINI-1 board">
+</p>
+
+## Prerequisites
+
+- Python 3.12 or newer
+- A [CopperPilot](https://copperpilot.ai) account for login
+- KiCad 10 on `PATH` only if you run [`examples/001_esp32`](examples/001_esp32)
+
+## Install and run
+
+```console
+pip install copper-pilot-cli
+copper-pilot
+```
+
+The first interactive launch opens a browser for CopperPilot device login.
+With no path argument, the current directory is the workspace and a new chat
+starts immediately. Any existing directory is valid.
+
+```console
+copper-pilot ./my-board
+copper-pilot --resume
+copper-pilot threads list
+copper-pilot -n -m "Review this board" --json
+```
+
+Both `copper-pilot` and `copper-pilot-cli` run the same program.
+`copper-pilot --help` lists flags; [docs/cli.md](docs/cli.md) is the full
+command reference.
+
+## Configuration
+
+- Production API: `https://copperpilot.ai`
+- Development override: `COPPER_PILOT_API_URL`
+- User state: `~/.copper-pilot/.state`
+- Project artifacts: `.copperpilot/`
+
+Credentials are stored in a private, atomically replaced `auth.json`; on POSIX
+the parent directory is mode `0700` and the file is mode `0600`.
+
+## LangChain
+
+```python
+from copper_pilot_cli.copper_protocol import CopperMode
+from copper_pilot_cli.langchain import CopperPilotAgent
+from helper import drc_violations, erc_errors, render_pcb, run
+
+PLAN = CopperMode.PLAN
+
+copper_pilot = CopperPilotAgent(workspace="esp32")
+
+run(copper_pilot, "Build me an ESP32 dev board.", PLAN)
+run(copper_pilot, "Let us build this plan.")
+run(copper_pilot, "Inspect the PCB, check for any missing 3D models, and apply them accordingly.")
+
+assert erc_errors() == 0
+assert drc_violations() == 0
+render_pcb("esp32.png")
+```
+
+`CopperPilotAgent` is a `Runnable`, not a chat model. It represents a complete
+hosted agent run, including local tool requests. Use `as_langgraph()` for graph
+composition or `as_compiled_subagent()` for explicit delegation from an outer
+Deep Agent. The compatible `deepagents` runtime is installed and pinned by this
+package.
+
+That snippet is the runnable example in
+[`examples/001_esp32`](examples/001_esp32).
+
+## Security boundary
+
+The hosted agent may request local filesystem and shell tools. Reads and
+searches run freely. Writes, edits, deletes, and shell commands are gated by
+Manual approval by default. Auto permits only deterministic routine actions;
+unknown actions still ask. YOLO must be selected explicitly.
+
+Filesystem, search, edit, and shell execution use Deep Agents' native
+`FilesystemMiddleware` tools and `LocalShellBackend`; CopperPilot's adapter only
+normalizes hosted tool names, approval decisions, and result envelopes.
+
+Computer use, model/provider selection, local model execution, LangSmith
+tracing, content telemetry, MCP/plugin controls, and server implementation code
+are not part of this package.
+
+See [UPSTREAM.md](UPSTREAM.md) and [NOTICE](NOTICE) for the retained Textual
+client attribution.
+
+To report a vulnerability, see [SECURITY.md](SECURITY.md).
+
+## Development
+
+```console
+pip install -e ".[dev]"
+make fmt
+make lint
+make test
+```
+
+`make test` runs `pytest -m "not live"`. Live tests skip unless a CopperPilot
+credential is stored. Release tagging is `make release`. Details:
+[docs/development.md](docs/development.md).
+
+## Contributing
+
+Bug reports, features, and pull requests are welcome. Please read
+[CONTRIBUTING.md](CONTRIBUTING.md) and the
+[Code of Conduct](CODE_OF_CONDUCT.md). Use the
+[bug report form](https://github.com/CopperPilot/copper-pilot-cli/issues/new?template=bug_report.yml)
+so we can reproduce the problem.
+
+## License
+
+[MIT](LICENSE).