Index of every page on this site: llms.txt
All skills
comet-ml avatar

/local-dev

@9b3d88e
by Cometcomet-ml/opik23k stars
1,964
Run it yourself

Local development environment setup and commands. Use when helping with dev server, Docker, or local testing.

Use this Skill: https://skilld.dev/gh/comet-ml/opik/local-dev

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈30 tokens for metadata: the name and description. ≈699 when used: this file.

Description uses 1.5% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈121 characters, or 1.5%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Local Development

Quick Start

./scripts/dev-runner.sh --restart   # First time / full rebuild
./scripts/dev-runner.sh --start     # Daily start (no rebuild)
./scripts/dev-runner.sh --stop      # Stop everything
./scripts/dev-runner.sh --verify    # Check status

Modes

Mode Command Frontend Use When
Standard --restart localhost:5174 Frontend work, full-stack
BE-only --be-only-restart localhost:5173 Backend-focused, faster rebuilds
Platform (EM) PLATFORM_ENABLED=true ./scripts/dev-runner.sh --restart localhost:9100 Opik-team only: run Opik connected to the Comet Platform

Platform (EM) mode — Opik-team only

PLATFORM_ENABLED=true runs the Comet EM/Platform stack (comet-backend + comet-react, auto-detected sibling checkouts) alongside Opik behind a single-origin nginx proxy, with Opik in comet mode authenticating/resolving workspaces via comet-backend. Off by default — Standard/BE-only dev is unaffected. comet-backend builds under a detected JDK 17/21; Opik still uses JDK 25.

PLATFORM_ENABLED=true ./scripts/dev-runner.sh --restart   # then also --start/--stop/--verify
# Integrated UI:  http://localhost:9100        (comet-react / Platform)
#                 http://localhost:9100/opik   (Opik, comet mode)

Env vars (COMET_BACKEND_PATH, COMET_REACT_PATH, PLATFORM_JAVA_HOME, PLATFORM_*_PORT) and --platform-build are documented in ./scripts/dev-runner.sh --help.

URLs

Build Commands

./scripts/dev-runner.sh --build-be   # Backend only
./scripts/dev-runner.sh --build-fe   # Frontend only
./scripts/dev-runner.sh --lint-be    # Spotless
./scripts/dev-runner.sh --lint-fe    # oxlint + oxfmt
./scripts/dev-runner.sh --migrate    # DB migrations

Logs

tail -f /tmp/opik-backend.log        # Backend
tail -f /tmp/opik-frontend.log       # Frontend (standard)
docker logs -f opik-frontend-1       # Frontend (BE-only)

SDK Config

export OPIK_URL_OVERRIDE='http://localhost:8080'
export OPIK_WORKSPACE='default'

Troubleshooting

Won't start:

./scripts/dev-runner.sh --verify
lsof -i :8080                        # Port conflict?
./scripts/dev-runner.sh --stop && ./scripts/dev-runner.sh --restart

Build fails:

cd apps/opik-backend && mvn clean install -DskipTests
cd apps/opik-frontend && rm -rf node_modules && npm install

Database issues:

./scripts/dev-runner.sh --stop
./opik.sh --clean                    # WARNING: deletes data
./scripts/dev-runner.sh --restart

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 alert8mo4 checks · Risk SAFE
  • Gen Agent Trust Hub8mo

    The skill provides commands for managing a local development environment, including building, running, and troubleshooting services. It utilizes project-specific scripts and standard development tools such as Docker, Maven, and npm, with all operations restricted to the local system.

  • Socket8mo

    No alerts

  • Snyk8mo

    Risk: LOW · No issues

  • Runlayer8mo

    1/1 file flagged

Signed by skilld at 9b3d88e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 4 days ago

README badge

README badge for comet-ml/opik/local-dev