Choose your operating system and package manager. The normal release options, including pentect-bin, use a prebuilt binary. The opt-in pentect-git AUR package builds the Rust workspace on your machine.

Install

OS

Method

irm https://pentect.dev/install | iex

Installed?Continue to Quick start→

Pentect is currently distributed through its own flake, not as a package in Nixpkgs. Use github:EdamAme-x/pentect#pentect; nix run nixpkgs#pentect cannot work until Pentect is accepted into the upstream Nixpkgs collection.

Check the install

pentect doctor

doctor checks Pentect and the AI clients installed on your machine. To apply a fix after reviewing it, run pentect doctor --fix.

Start a client

Use Pentect for one session:

pentect codex
# or
pentect claude

To keep the shorter client command, ask Pentect to update your shell profile:

pentect codex --set-default
pentect claude --set-default

The change is shown before approval and can be removed later with --unset-default. See Quick start for the full flow.

If you use a desktop App often, install a separate protected launcher:

pentect codex app --install-launcher
pentect claude app --install-launcher

The launcher is optional. It appears as Codex via Pentect or Claude via Pentect and does not replace the official App. Quit the official App before opening the protected launcher.

Install a specific version

Use the same installer with a version number:

PowerShell

& ([scriptblock]::Create((irm https://pentect.dev/install))) -Version X.Y.Z

Shell

curl -fsSL https://pentect.dev/install.sh | sh -s -- --version X.Y.Z

npm

npm i -g pentect@X.Y.Z

Homebrew, APT, AUR, and Nix choose versions through their normal package-manager workflow. A Nix flake lock file keeps the selected revision.

Update

Run pentect update. Pentect uses its installation record to update through the original package manager when required, including global and project-local npm installations.

For AUR installations, select the update command matching the package you installed.

Direct installer

pentect update

# Or choose a version
pentect update X.Y.Z

npm

pentect update

Homebrew

brew update
brew upgrade pentect

APT

sudo apt update
sudo apt install --only-upgrade pentect

AUR — pentect-bin

paru -S pentect-bin

AUR — pentect-git

paru -S pentect-git

Nix profile

nix profile upgrade pentect

NixOS flake

nix flake update pentect
sudo nixos-rebuild switch --flake .#HOSTNAME

On Arch Linux, pentect-bin is the normal release package. Use paru -S pentect-git if you intentionally want to build the latest main branch. paru is only an example: yay and a manual makepkg workflow are supported as well. For pentect-git, pentect version reports the upstream manifest version; use pacman -Q pentect-git to see the full VCS package version.

NixOS configuration

Add Pentect to your flake input and system packages:

# flake.nix
inputs.pentect.url = "github:EdamAme-x/pentect";

outputs = inputs@{ nixpkgs, ... }: {
  nixosConfigurations.HOSTNAME = nixpkgs.lib.nixosSystem {
    specialArgs = { inherit inputs; };
    modules = [ ./configuration.nix ];
  };
};

# configuration.nix
{ pkgs, inputs, ... }:
{
  environment.systemPackages = [
    inputs.pentect.packages.${pkgs.system}.default
  ];
}

Then rebuild with the host name from your flake:

sudo nixos-rebuild switch --flake .#HOSTNAME

Uninstall

Remove any shell defaults or App launchers first:

pentect codex --unset-default
pentect claude --unset-default
pentect codex app --remove-launcher
pentect claude app --remove-launcher

For a direct PowerShell or shell install:

pentect uninstall

For npm, Homebrew, APT, AUR, or Nix, uninstall Pentect with that package manager. For AUR packages, run sudo pacman -Rns pentect-bin or sudo pacman -Rns pentect-git, matching the installed package. Project .pentect settings and user data are not removed automatically.