CLI¶

pip install klangkc

klangkc login admin@example.com        # authenticate (prompts for password)
klangkc ls                               # list workspaces
klangkc create my-project                # create a workspace
klangkc create my-project --mount ~/src:/home/klangk/work/src          # with bind mount
klangkc create my-project --mount nix-store:/nix           # with named volume
klangkc create my-project --env FOO=bar                      # with env vars
klangkc edit my-project                  # interactive edit (name, image, command, mounts, env)
klangkc edit my-project --env FOO=bar    # set env var via flag
klangkc dup my-project my-copy           # duplicate a workspace
klangkc shell my-project                 # drop into bash inside the container
klangkc sandbox myws                     # create/reconnect from .klangk/sandbox.yaml
klangkc sandbox myws ~/projects/myapp    # specify sandbox root explicitly
klangkc sandbox myws --force-setup       # re-run copy and setup on existing workspace
klangkc exec my-project ls /home/klangk/work         # run a command in the container
klangkc sync ~/src my-project:/home/klangk/work      # sync files to/from the container
klangkc rm my-project                # delete a workspace
klangkc restart my-project           # restart the container for a workspace (owner only)
klangkc export my-project            # export workspace to my-project.tar.gz (admin only)
klangkc export my-project -o bak.tar.gz  # export to specific file
klangkc import bak.tar.gz            # import workspace from archive
klangkc import bak.tar.gz --name new-name  # import with a different name
klangkc members my-project           # list workspace members by role
klangkc share my-project user@x.com  # share workspace (default: coder role)
klangkc share my-project user@x.com --role=spectator  # share with specific role
klangkc unshare my-project user@x.com # remove a user from all roles
klangkc terminal ls my-project       # list all terminals (own + shared)
klangkc terminal share my-project bash        # share a terminal with workspace members
klangkc terminal unshare my-project bash      # stop sharing a terminal
klangkc invite user@example.com      # send an invitation email (admin only)
klangkc invitations                  # list all invitations (admin only)
klangkc images                       # list available container images
klangkc volumes ls                   # list your podman volumes
klangkc volumes create nix-store     # create a named volume (owned by you)
klangkc volumes rm nix-store         # delete a volume (must be yours)