open-index/open-npm huggingface dataset:
npm package: @instafy/cli
Description: Run Instafy projects locally, link folders to Studio, and share previews/webhooks via tunnels.
Latest version: 0.1.11

<p align="center"><code>npm i -g @instafy/cli</code></p>

# Instafy CLI (Preview)

Run Instafy projects locally and connect them back to Instafy Studio — from any terminal.

## Quickstart

0. Log in once: `instafy login`
   - Opens a Studio URL; the CLI continues automatically after you sign in.
   - Also enables Git auth (credential helper) for Instafy Git Service. Disable with `instafy login --no-git-setup`.
   - Multiple accounts: `instafy login --profile work` (then bind folders with `instafy project init --profile work` or `instafy project profile work`).
   - Optional: set defaults with `instafy config set controller-url <url>` / `instafy config set studio-url <url>`
1. Link a folder to a project:
   - VS Code: install the Instafy extension and run `Instafy: Link Workspace to Project`, or
   - Terminal: `instafy project init`
2. Start the runtime: `instafy runtime start`
3. Check status / stop:
   - `instafy runtime status`
   - `instafy runtime stop`

## Common commands

 - `instafy runtime start` — start a local runtime (agent + origin).
- `instafy runtime status` — show health of the last started runtime.
 - `instafy runtime stop` — stop the last started runtime.
- `instafy git <args...>` — run git commands against an Instafy canonical checkout (`.instafy/.git`) when present.
- `instafy tunnel start` — start a detached tunnel for a local port.
  - `instafy tunnel list` — list local tunnels started by the CLI.
  - `instafy tunnel logs <tunnelId> --follow` — tail tunnel logs.
  - `instafy tunnel stop <tunnelId>` — stop + revoke a tunnel.
- `instafy api get` — query controller endpoints (conversations, messages, runs, etc).

Run `instafy --help` for the full command list and options.

## Docs

- CLI reference & troubleshooting: https://github.com/instafy-dev/instafy/blob/main/docs/CLI.md
npm package: @instafy/provider-contract
Description: Neutral provider discovery and invocation contract shared between Instafy and external providers.
Latest version: 0.1.1

# @instafy/provider-contract

Small neutral contract package for local or external providers.

It intentionally contains only:

- provider discovery metadata
- tool/resource envelope types
- shared runtime, execution, event, and artifact envelope types
- tiny provider summary normalization and lookup helpers

It must stay independent from Instafy frontend, project policy, assistant definitions, and UI.

This package is intended to be published independently so external provider repos
like Knosh can validate against the host-facing contract without depending on a
local sibling Instafy checkout.

It is not a callback framework. The intended generalization is:

- provider runtime context
- execution context
- typed provider events
- artifact references

That lets external providers and host apps share one neutral event/artifact loop
without coupling Instafy UI or provider-specific lifecycle code into the package.