@ideaspaces/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IdeaSpaces
+
+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.

package/README.md

@@ -0,0 +1,113 @@
+# ideaspaces
+
+> Persistent, searchable knowledge from the command line.
+
+`ideaspaces` is the CLI for [IdeaSpaces](https://ideaspaces.xyz) — a place where teams of people and agents maintain shared understanding. A **space** is a git repository where knowledge compounds: notes are state, conversations are process, and the directory tree is how you navigate. This CLI is the fastest way to work with a space: clone it locally, edit and capture, search, push and pull, and talk to an agent — online or fully local.
+
+## Install
+
+```sh
+npm install -g @ideaspaces/cli
+```
+
+This installs the `ideaspaces` command. Node 20+ is required.
+
+## Quick start
+
+```sh
+ideaspaces login                    # authenticate
+ideaspaces clone alice/notes        # clone a space to a local working copy
+cd notes
+ideaspaces navigate .               # orient: what's here, what changed
+ideaspaces write ideas.md           # edit a note
+ideaspaces commit -m "…" ideas.md   # save the capture
+ideaspaces push                     # send your commits to the remote
+ideaspaces pull                     # integrate others' changes
+```
+
+Everything is local-first: your working copy is a real git clone on disk. Edits are yours until you `push`.
+
+## Commands
+
+Run `ideaspaces <command> --help` for full usage. `--json` is available on most read commands for scripting.
+
+### Spaces & content
+| Command | What it does |
+|---|---|
+| `clone <namespace/slug> [dir]` | Clone a space into a local working copy |
+| `clones` | List your local working copies |
+| `create <name>` | Create a new space |
+| `repos` | List spaces you can access |
+| `link <dir> <namespace/slug>` | Bind an existing local directory to a space |
+
+### Editing & capture
+| Command | What it does |
+|---|---|
+| `write <path>` | Create or edit a note |
+| `node <path>` | Read a single node (file) with its metadata |
+| `change` | Open a mutable capture (a tracked change set) |
+| `commit` | Commit captured changes with attribution trailers |
+
+### Sync & publish
+| Command | What it does |
+|---|---|
+| `push` | Send your committed captures to the remote |
+| `pull` | Integrate remote changes into your local copy |
+| `publish` | Publish a local space to the server |
+
+### Navigate & search
+| Command | What it does |
+|---|---|
+| `navigate <path>` | Orient at a position — contract, awareness, what changed |
+| `catalog` | List the nodes at a position |
+| `ls [<path>]` | List files and folders under a path, typed (folder / repo / ideaspace) |
+| `search <query>` | Full-text search (filename + BM25) over the local clone |
+| `status` | Working-copy status (ahead / behind / dirty) |
+| `skills` | List the skill catalog, or print one skill's markdown |
+
+### Collaborate
+| Command | What it does |
+|---|---|
+| `conversation` | Start or continue a conversation (online or `--local`) |
+| `conversations` | List conversations |
+| `share` | Manage members, invites, and public links |
+| `agents` | List agents available to you |
+| `times` | Activity timeline |
+
+### Identity
+| Command | What it does |
+|---|---|
+| `login` | Authenticate and store credentials |
+| `whoami` | Show the current identity |
+| `forget` | Remove stored credentials |
+| `power logout` | Log out and clear stored credentials |
+| `credential` | Git credential helper (used by git under the hood) |
+
+### Local agent (Pi)
+Run an agent over your local working copy — offline, on your own key.
+| Command | What it does |
+|---|---|
+| `pi-status` | Is a local agent runtime available and configured? |
+| `pi-login` | Configure a model provider (writes the local agent's credentials) |
+| `pi-logout` | Remove a configured model provider |
+| `pi-models` | List the models a configured provider offers |
+| `conversation send --local` | Run a local agent turn over a folder |
+
+## Configuration
+
+| Path | What |
+|---|---|
+| `~/.ideaspaces/credentials.json` | Your API credentials |
+| `~/.ideaspaces/spaces.json` | Known spaces and their remotes |
+| `~/.pi/agent/auth.json` | Local-agent model-provider credentials |
+
+### Environment variables
+| Variable | What |
+|---|---|
+| `IS_API_KEY` | API key (overrides stored credentials) |
+| `IS_API_URL` | API base URL (defaults to the hosted service) |
+| `IDEASPACES_PI_EXTENSIONS` | Comma-separated extension paths for the local agent |
+
+## License
+
+MIT