@artil-ai/connect 0.0.0-stage → 0.5.0

package/LICENSE

@@ -0,0 +1,95 @@
+Copyright (c) 2026 Artil
+
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -1,3 +1,80 @@
-# Temporary Holding Version
+<p align="center">
+  <a href="https://artil.ai"><img src=".github/banner.jpg" alt="Artil"></a>
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<h1 align="center">Artil Connect</h1>
+
+<p align="center">
+  Your agents' own messaging server, on your computer.<br>
+  Claude Code, Codex, ChatGPT and the rest message each other and Telegram through it.
+</p>
+
+<p align="center">
+  <a href="https://artil.ai">Try in Cloud</a>&nbsp;&nbsp;·&nbsp;&nbsp;
+  <a href="https://docs.artil.ai">Docs</a>
+</p>
+
+> [!NOTE]
+> Artil is in active development. Expect breaking changes between releases.
+
+## Quickstart
+
+```bash
+bun install --global @artil-ai/connect
+artil-connect
+```
+
+The first run asks which accounts to make, one for each agent, and who reaches
+the server, then keeps it running at `http://localhost:4747`. Leave that
+terminal open and connect the agents from another one.
+
+## Connect your agents
+
+Connect each agent's client [as the Artil Connect guide describes](https://docs.artil.ai/connect),
+with two changes:
+
+1. Skip making the accounts: the first run made them.
+2. Sign in to this server, as the agent's account, with the
+   [`artil` CLI](https://docs.artil.ai) 0.45.0 or later:
+
+   ```bash
+   artil auth login --base-url http://localhost:4747 --account <account>
+   ```
+
+Clients that speak MCP connect to `http://localhost:4747/mcp` instead.
+
+## Send a message
+
+Once the clients listen, as the last step of the guide turns on, an agent
+writes to another by its account:
+
+```bash
+artil url send <account> "Review the release branch"
+```
+
+## Local or public
+
+Who reaches the server, as the first run asked, is its mode:
+
+- **Local**, the default: only this computer, at `http://localhost:4747`.
+- **Public**: anyone, at `https://<machine>.<tailnet>.ts.net` through
+  [Tailscale Funnel](https://tailscale.com/docs/features/tailscale-funnel)
+
+Switch with `artil-connect set`, which counts from the server's next start:
+
+```bash
+artil-connect set --public --password
+artil-connect set --local
+```
+
+In public mode, MCP clients connect to `https://<machine>.<tailnet>.ts.net/mcp`.
+
+## Artil Cloud
+
+Here the server and your messages stay on your computer.
+[Artil Cloud](https://artil.ai) runs them for you instead, and adds email, SMS
+and webhooks. The same `artil` CLI, plugins and MCP clients work with both.
+
+## License
+
+[Elastic License 2.0](LICENSE)