Skip to content
Open
Show file tree
Hide file tree
Changes from 17 commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
bd82371
feat: Add cross-platform installation scripts
bishoy-at-pieces Jul 9, 2025
5b625cf
feat: Add manage command group with update, status, and uninstall
bishoy-at-pieces Jul 9, 2025
67a58ba
feat: Integrate manage command into CLI
bishoy-at-pieces Jul 9, 2025
fd6923b
docs: Update README with installation scripts and manage command
bishoy-at-pieces Jul 9, 2025
b9aa430
add update POS command
bishoy-at-pieces Jul 9, 2025
2fe3b41
add pieces status to the manage update command
bishoy-at-pieces Jul 9, 2025
edc982f
fix formating
bishoy-at-pieces Jul 9, 2025
db83732
add change the structure of the commands (pieces update) to update Pi…
bishoy-at-pieces Jul 14, 2025
b263422
Merge branch 'main' into feature/cross-platform-installation-scripts
bishoy-at-pieces Jul 14, 2025
6f49ab1
Merge branch 'main' into feature/cross-platform-installation-scripts
bishoy-at-pieces Jul 14, 2025
8e7d159
fix weak python version parsing
bishoy-at-pieces Jul 14, 2025
f5f9503
add new choco and winget in the manage command
bishoy-at-pieces Jul 14, 2025
cfc3841
add cleanup function
bishoy-at-pieces Jul 14, 2025
4034f17
Fix security issues in PATH manipulation:
bishoy-at-pieces Jul 14, 2025
3f457ac
ensure reliability in the installation scripts
bishoy-at-pieces Jul 15, 2025
5bfa8af
Merge branch 'main' into feature/cross-platform-installation-scripts
bishoy-at-pieces Jul 15, 2025
927a234
fix colors in the status
bishoy-at-pieces Jul 15, 2025
de7d866
ensure reliablity in the sh script
bishoy-at-pieces Jul 15, 2025
0143854
refactor: Modularize manage commands into separate files
bishoy-at-pieces Jul 15, 2025
1e3956b
fix: Skip onboarding for completion command
bishoy-at-pieces Jul 15, 2025
d7afe69
Docs & Security Helpers For Inspo
tsavo-at-pieces Jul 18, 2025
d5bed75
comment the installer script method until it is save
bishoy-at-pieces Jul 23, 2025
394d274
Merge branch 'main' into feature/cross-platform-installation-scripts
bishoy-at-pieces Aug 28, 2025
9f0c329
add checksums and installation security
bishoy-at-pieces Aug 28, 2025
0bf485f
feat: add dependency logging
bishoy-at-pieces Aug 28, 2025
2ca25d3
fix: resolve Path.exists patching issues in executable location tests
bishoy-at-pieces Aug 28, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 28 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
</p>

##### <p align="center"> [Website](https://pieces.app/) • [PiecesOS Documentation](https://docs.pieces.app/) • [Pieces CLI Documentation](https://docs.pieces.app/extensions-plugins/cli)

</p>

[![Introducing CLI](https://img.youtube.com/vi/kAgwHMxWY8c/0.jpg)](https://www.youtube.com/watch?v=kAgwHMxWY8c)
Expand All @@ -30,6 +31,27 @@ To get started with the Pieces Python CLI Tool, you need to:
1. Ensure PiecesOS is installed and running on your system.
2. Install the Python package:

**Installer Script (Recommended):**

> **Requirements:** Python 3.11 or higher is required for the installation scripts.

```bash
# macOS/Linux (Bash)
sh <(curl -fsSL https://raw.githubusercontent.com/pieces-app/cli-agent/main/install_pieces_cli.sh)
```

```fish
# macOS/Linux (Fish)
sh (curl -fsSL https://raw.githubusercontent.com/pieces-app/cli-agent/main/install_pieces_cli.sh | psub)
```

```powershell
# Windows (PowerShell)
irm https://raw.githubusercontent.com/pieces-app/cli-agent/main/install_pieces_cli.ps1 | iex
```

**Package Managers:**

```bash
pip install pieces-cli
```
Expand All @@ -46,12 +68,6 @@ To get started with the Pieces Python CLI Tool, you need to:

After installing the CLI tool, you can access its functionalities through the terminal. The tool is initialized with the command `pieces` followed by various subcommands and options.

### Some important terminologies

- `x` -> The index
- `current asset` -> The asset that you are currently using can be changed by the open command
- `current conversation` -> The conversation that you currently using in the ask command

## Shell Completion

The Pieces CLI supports auto-completion for bash, zsh, fish, and PowerShell. To enable completion for your shell, run:
Expand All @@ -63,21 +79,25 @@ pieces completion [shell]
**Quick setup commands for each shell:**

- **Bash:**

```bash
echo 'eval "$(pieces completion bash)"' >> ~/.bashrc && source ~/.bashrc
```

- **Zsh:**

```zsh
echo 'eval "$(pieces completion zsh)"' >> ~/.zshrc && source ~/.zshrc
```

- **Fish:**

```fish
echo 'pieces completion fish | source' >> ~/.config/fish/config.fish && source ~/.config/fish/config.fish
```

- **PowerShell:**

```powershell
Add-Content $PROFILE '$completionPiecesScript = pieces completion powershell | Out-String; Invoke-Expression $completionPiecesScript'; . $PROFILE
```
Expand Down Expand Up @@ -153,7 +173,7 @@ cd dist
pip install pieces-cli-{VERSION}-py3-none-any.whl
```

replace the VERSION with the version you downloaded
Replace the VERSION with the version you downloaded
Note: Ensure you get latest from the [releases](https://github.com/pieces-app/cli-agent/releases) of the cli-agent

11. To view all the CLI Commands
Expand Down Expand Up @@ -198,7 +218,7 @@ coverage report
To uninstall the project, run the following command:

```shell
pip uninstall pieces-cli
pieces manage uninstall
```

Don't forget to remove the virtual environment and dist folder
Expand Down
Loading