Skip to content

quickstart.md

Latest commit

 

History

History
57 lines (43 loc) · 1.43 KB

quickstart.md

File metadata and controls

57 lines (43 loc) · 1.43 KB

Quickstart: cc-deck Base Container Image

Using the Base Image

Pull and run:

podman pull ghcr.io/rhuss/cc-deck-base:latest
podman run -it --rm ghcr.io/rhuss/cc-deck-base:latest

You'll land in a zsh shell as the coder user with all tools available.

Building the Base Image

From the cc-deck repo root:

cd base-image/
podman build -t cc-deck-base:local .

Multi-arch build:

podman build --platform linux/amd64 -t cc-deck-base:amd64 .
podman build --platform linux/arm64 -t cc-deck-base:arm64 .
podman manifest create cc-deck-base:latest cc-deck-base:amd64 cc-deck-base:arm64

Using as a Base for Project Images

FROM ghcr.io/rhuss/cc-deck-base:latest

# Add project-specific tools (generated by cc-deck.containerfile)
RUN dnf install -y golang && dnf clean all

# Install cc-deck (self-embedding from build context)
COPY cc-deck /usr/local/bin/cc-deck
RUN cc-deck plugin install --install-zellij --force

# Install Claude Code
RUN npm install -g @anthropic-ai/claude-code

USER coder
WORKDIR /home/coder

Verifying the Image

podman run --rm cc-deck-base:local sh -c '
  git --version && gh --version && node --version && python3 --version &&
  rg --version && fd --version && bat --version && lsd --version &&
  delta --version && fzf --version && zoxide --version && starship --version &&
  hx --version && jq --version && yq --version && uv --version &&
  echo "All tools OK"
'