Status

When to use

Quick health check before deploying
Verify you’re authenticated to the right organization
Check if a use case folder is ready to deploy
Diagnose profile mismatches between your active profile and the project’s org

Prerequisites

codika CLI installed (authentication is checked but not required)

Command

codika status [path] [options]

Arguments

Argument	Description
`[path]`	Path to check (defaults to current directory)

Options

Option	Description
`--json`	Output as JSON
`--project-file <path>`	Path to custom project file (default: `project.json`)
`--verify`	Run quick validation on the detected use case

Output sections

Identity

Shows the current authenticated state:

Identity:
  Status:       Logged in
  Organization: Acme Corp
  Profile:      acme-corp
  Key:          cko_abc...xyz

Use case context

If a use case folder is detected at the path:

Use Case:
  Detected:     ✓
  Title:        Email Automation
  Version:      1.2.3
  Workflows:    3
  Project ID:   abc123
  Profile:      ✓ match (acme-corp)

Profile match status

Status	Meaning
`match`	Active profile’s org matches `project.json` org — ready to deploy
`mismatch`	Different org — shows suggested profile to switch to
`no-org-in-project`	No `organizationId` in `project.json`
`no-profile`	Not logged in

Readiness

Shows whether the use case is ready to deploy:

Readiness:
  ✓ Ready to deploy

Or with issues:

Readiness:
  ✗ Not ready to deploy
    - No project.json found
    - Profile org does not match project org (try: codika use staging)

Warnings

Profile mismatch: “Active profile ‘acme-corp’ does not match project org. Suggested: ‘staging’”
Key expiry < 7 days: “API key expires in 3 days”
Key expired: “API key has expired”

Examples

# Check status in current directory
codika status

# Check a specific directory
codika status ./email-automation

# Check with validation
codika status ./email-automation --verify

# Machine-readable output
codika status --json

Exit codes

Code	Meaning
`0`	Ready to deploy
`1`	Not ready (issues found)

Overview

Setup

Build

Deploy

Operate

When to use

Prerequisites

Command

Arguments

Options

Output sections

Identity

Use case context

Profile match status

Readiness

Warnings

Examples

Exit codes

​When to use

​Prerequisites

​Command

​Arguments

​Options

​Output sections

​Identity

​Use case context

​Profile match status

​Readiness

​Warnings

​Examples

​Exit codes

When to use

Prerequisites

Command

Arguments

Options

Output sections

Identity

Use case context

Profile match status

Readiness

Warnings

Examples

Exit codes