Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

account

Local account index commands: build a snapshot of every resource, then search, walk the dependency graph, lint, and count from it offline.

Note: account commands operate on a LOCAL index file (~/.celigo/indexes/<profile>.json). They are not REST-backed; no "Corresponds to" API endpoint. For token identity see profile whoami; for applications in use see connections applications.

celigo account <subcommand> [args] [flags]

Supports all global flags. The index is created by account snapshot and read by search, dependencies, lint, and stats. All four readers auto-refresh when the index is older than 15 minutes (or CELIGO_INDEX_STALE_MINUTES); pass --no-refresh to skip.

Subcommands

Subcommand
Purpose

snapshot

Fetch every resource and write the local account index.

search <query>

Scored keyword search across the index.

dependencies <type> <id>

Show the dependency graph for one resource.

lint

Run anomaly-detection rules against the index.

stats

Resource counts by type.

celigo account snapshot

Fetches integrations, flows, connections, exports, imports, scripts, stacks, apis, and iclients, builds a dependency graph, and writes the whole thing to ~/.celigo/indexes/<profile>.json (mode 0600).

Since celigo-cli 2026.8.7 the flow listing includes instance flows (the same includeInstances behavior as flows list --include-instances), so the reference graph carries abstract↔instance edges — account dependencies flow <abstractId> --direction used-by enumerates an abstract flow's instances.

Signature

celigo account snapshot

Arguments

None.

Flags

None (beyond global flags).

Example

This is a local index for fast offline queries — not a per-file backup. For a Git-friendly dump of resource bodies, use celigo <resource> list --format json and celigo <resource> get <id> in a loop.

celigo account search

Scored keyword search across name, _id, type, adaptorType, and _connectionId on every indexed resource. Terms are space-split; score is the number of matching terms.

Signature

Arguments

Argument
Type
Required
Description

<query>

string

Yes

Space-separated search terms.

Flags

Flag
Type
Default
Description

--type <type>

string

—

Filter results by resource type (e.g. flow, connection, export, import, script, stack, api, iclient, integration).

--limit <n>

number

20

Maximum number of results to return.

--no-refresh

boolean

—

Skip auto-refresh of a stale index.

Example

celigo account dependencies

Prints the dependency graph for one resource: what it uses (outgoing edges) and/or what usedBy references it (incoming edges). Edges are built from flow → integration/export/import/script, export/import → connection/script, and script hooks.

Signature

Arguments

Argument
Type
Required
Description

<type>

string

Yes

Resource type: flow, integration, connection, export, import, script, stack, api, iclient.

<id>

string

Yes

Resource _id.

Flags

Flag
Type
Default
Description

--direction <dir>

uses | used-by | both

both

Which side of the graph to print.

--no-refresh

boolean

—

Skip auto-refresh of a stale index.

Example

celigo account lint

Runs anomaly-detection rules against the index and prints issues with severity, rule, resourceType, resourceName, and message. Exits 0 regardless of issue count — gate on the output yourself (see CI example below).

Signature

Arguments

None.

Flags

Flag
Type
Default
Description

--no-refresh

boolean

—

Skip auto-refresh of a stale index.

Example

Lint rules

Rule
Severity
Description

offline-connection-in-use

error

An offline connection referenced by at least one enabled flow (directly or via an export/import).

orphaned-export

warning

Export not referenced by any flow.

orphaned-import

warning

Import not referenced by any flow.

orphaned-connection

warning

Connection not used by any export or import.

no-trigger

warning

Enabled flow with no schedule and no WebhookExport in its page generators. Skips abstract templates (which never run directly) and instance flows (whose trigger lives on the abstract's structure plus per-instance overrides).

CI example

celigo account stats

Emits a count per resource type plus a total and the index timestamp.

Signature

Arguments

None.

Flags

Flag
Type
Default
Description

--no-refresh

boolean

—

Skip auto-refresh of a stale index.

Example

Gotchas

  1. Local index only. The snapshot lives at ~/.celigo/indexes/<profile>.json and is written mode 0600. Delete the file to force a cold rebuild; there is no server-side copy.

  2. Per-profile. Each profile has its own index file. Switching profiles reads (and refreshes) the corresponding file — snapshots never mix.

  3. Staleness threshold is 15 minutes. Override with CELIGO_INDEX_STALE_MINUTES (integer, minutes). Pass --no-refresh to skip the auto-refresh entirely (useful in CI when you've just run snapshot explicitly).

  4. Partial snapshots are not fatal. If one resource type fails to fetch, snapshot logs a yellow warning and continues with an empty list for that type — dependency and lint results will reflect the gap.

  5. snapshot is not a backup. It stores enough fields to search and graph, not enough to re-create resources. Use celigo <resource> get <id> --format json for Git-friendly dumps.

  6. Legacy migration. A pre-profile ~/.celigo/account-index.json is auto-migrated to ~/.celigo/indexes/default.json on first read.

Related

  • profile — manage the profile whose index is read/written here; profile whoami resolves the active token's identity.

  • connections — connections applications lists the external applications in use across the account.

  • config — ~/.celigo/config.json lives alongside ~/.celigo/indexes/.

  • Per-resource pages the index is built from: integrations, flows, connections, exports, imports, scripts, stacks, apis, iclients.

PreviousCommand reference
Nextai-agents

Last updated

Was this helpful?