chubbyts-framework-skeleton

Description

A minimal skeleton for chubbyts-framework.

Requirements

• node: 22
• @chubbyts/chubbyts-dic: ^2.2.0
• @chubbyts/chubbyts-dic-config: ^2.2.0
• @chubbyts/chubbyts-dic-types: ^2.2.0
• @chubbyts/chubbyts-framework: ^3.1.3
• @chubbyts/chubbyts-framework-router-path-to-regexp: ^3.1.3
• @chubbyts/chubbyts-http-error: ^3.3.0
• @chubbyts/chubbyts-log-types: ^3.2.0
• @chubbyts/chubbyts-pino-adapter: ^3.2.0
• @chubbyts/chubbyts-undici-server: ^1.1.3
• @chubbyts/chubbyts-undici-server-node: ^1.1.3
• commander: ^14.0.3
• pino: ^10.3.1

Environment

Add the following environment variable to your system, for example within ~/.bashrc or ~/.zshrc:

export USER_ID=$(id -u)
export GROUP_ID=$(id -g)

Mount points

bash

touch ~/.bash_docker
touch ~/.bash_history

zsh

touch ~/.zsh_docker
touch ~/.zsh_history

git

touch ~/.gitconfig
touch ~/.gitignore

npm

touch ~/.npmrc

Coding agents

Claude

if [ ! -f ~/.claude.json ]; then
    cat > ~/.claude.json <<'EOF'
{}
EOF
fi

mkdir -p ~/.claude

if [ ! -f ~/.claude/.credentials.json ]; then
    cat > ~/.claude/.credentials.json <<'EOF'
{}
EOF
fi

if [ ! -f ~/.claude/settings.json ]; then
    cat > ~/.claude/settings.json <<'EOF'
{
    "fileCheckpointingEnabled": false,
    "permissions": {
        "defaultMode": "bypassPermissions"
    },
    "skipDangerousModePermissionPrompt": true,
    "spinnerTipsEnabled": false,
    "switchModelsOnFlag": false,
    "theme": "auto"
}
EOF
fi

chmod 600 \
    ~/.claude/.credentials.json \
    ~/.claude/settings.json

Codex

mkdir -p ~/.codex

if [ ! -f ~/.codex/auth.json ]; then
    cat > ~/.codex/auth.json <<'EOF'
{}
EOF
fi

if [ ! -f ~/.codex/config.toml ]; then
    cat > ~/.codex/config.toml <<'EOF'
approval_policy = "never"
sandbox_mode = "danger-full-access"

[notice]
hide_full_access_warning = true
EOF
fi

chmod 600 \
    ~/.codex/auth.json
    ~/.codex/config.toml

Opencode

mkdir -p ~/.config/opencode ~/.local/share/opencode

if [ ! -f ~/.config/opencode/opencode.jsonc ]; then
    cat > ~/.config/opencode/opencode.jsonc <<'EOF'
{
    "$schema": "https://opencode.ai/config.json",
    "permission": {
        "*": "allow"
    }
}
EOF
fi

if [ ! -f ~/.config/opencode/tui.json ]; then
    cat > ~/.config/opencode/tui.json <<'EOF'
{
    "$schema": "https://opencode.ai/tui.json",
    "theme": "system",
    "tips": false
}
EOF
fi

if [ ! -f ~/.local/share/opencode/auth.json ]; then
    printf '{}\n' > ~/.local/share/opencode/auth.json
fi

chmod 600 \
    ~/.config/opencode/opencode.jsonc \
    ~/.config/opencode/tui.json \
    ~/.local/share/opencode/auth.json

PI

mkdir -p ~/.pi/agent
[ ! -f ~/.pi/agent/auth.json ] && echo '{}' > ~/.pi/agent/auth.json

Docker

docker-compose up -d
docker-compose exec node bash

Installation

pnpm start

Urls

• GET https://localhost/ping

Structure

Command

Commands is code that is meant to be executed on command line.

• src/command.ts

Handler

Handler alias Controller, or Controller actions to be more precise.

• src/handler.ts

ServiceFactory

Service factories are the glue code of the dependeny injection container.

• src/service-factory.ts

Copyright

2026 Dominik Zogg