From Zero to Trusted Agent in 30 Seconds

The 30 Second Version

If you are in a hurry, here is the whole thing:

npx credian login

That command:

1. Creates a Credian account (or signs in if you have one)
2. Registers a new agent with a unique SID
3. Generates an API key for that agent
4. Writes the API key to a .env file in your project
5. Confirms everything with a credian whoami check

You now have a registered agent with a starting trust score of 100.

Step by Step

Step 1: Run the login command

$ npx credian login

  Credian CLI v0.4.0

  To authorize this device, visit:
    https://credian.io/device
  and enter the code: WDJB-MJHT

  Waiting for approval...

  Logged in. Agent created.
  SID: cred_ag_7f8a2b...
  API Key: cred_sk_live_...

  Credentials saved to ~/.credian/config.json
  Run 'credian whoami' to verify.

Login uses OAuth2 device code: you approve the device in the browser, and the CLI mints an agent and API key for you. There is no email/password signup.

Step 2: Verify your identity

$ npx credian whoami

  Agent: my-research-agent
  SID: cred_ag_7f8a2b...
  Status: active
  Owner: developer@example.com
  Created: 2026-03-28T14:00:00Z

The whoami command confirms your API key resolves to the correct agent. This is useful for debugging (is my environment variable set correctly?) and for verification in CI/CD pipelines.

Step 3: Check your starting score

$ npx credian score

  Agent: my-research-agent
  Overall Score: 100 / 1000
  Confidence: low (3 events needed to activate dimensions)

  Breakdown:
    Reliability:  -- (inactive, 0 events)
    Financial:    -- (inactive, 0 events)
    Identity:     420 (registration complete)

  Tip: Report events to activate dimensions and build your score.

A brand new agent starts at 100 with only the identity dimension active. This is the cold start state. The CLI tells you exactly what is needed to activate the other dimensions: report at least 3 events of the relevant type.

Step 4: Install the SDK and report your first events

npm install credian

import { Credian } from 'credian';

const credian = new Credian({
  apiKey: process.env.CREDIAN_API_KEY,
});

// Report a task completion
await credian.events.report({
  type: 'task.completed',
  data: {
    taskType: 'market-research',
    duration: 45000,
    success: true,
  },
});

console.log('Event reported.');

After 3 task events, the reliability dimension activates. After 3 payment events, the financial dimension activates. The score starts climbing as the scoring engine has more data to work with.

Step 5: Watch your score grow

$ npx credian score

  Agent: my-research-agent
  Overall Score: 287 / 1000
  Confidence: low (47 events, need 50 for medium)

  Breakdown:
    Reliability:  620 (active, 35 events, 94.3% completion)
    Financial:    -- (inactive, 2 events)
    Identity:     420 (registration complete)

  Next milestone: 3 more events for medium confidence.

The CLI shows your progress toward the next milestone. In this case, 3 more events will push the agent from low to medium confidence, which increases the dampening multiplier from 0.3x to 0.7x and allows the score to climb significantly higher.

What the Score Means at Each Stage

• 100 (starting) — Brand new agent. Only identity data. No operational history.
• 200 to 400 — Early activity. Some dimensions active. Low confidence. Platforms will treat this as "new and unproven."
• 400 to 600 — Established agent. Multiple active dimensions. Medium confidence. Platforms will grant standard access.
• 600 to 800 — Trusted agent. High activity. High confidence. Platforms will grant elevated access and higher limits.
• 800+ — Elite agent. Extensive, diverse, verified activity. Maximum trust.

Most well built agents reach the 400 to 600 range within their first week of operation, assuming consistent activity and no failures. Reaching 800+ requires sustained, diverse, cross platform activity over weeks or months.

CLI Command Reference

# Initialize a new agent
npx credian login

# Check which agent this API key belongs to
npx credian whoami

# View your current trust score
npx credian score

# View a detailed score report
npx credian report

Common First Steps After Setup

1. Add event reporting to your agent code — Report task.completed, task.failed, and task.timeout events as your agent operates.
2. Add a score check before financial operations — Query credian.scores.get() and set minimum thresholds.
3. Add the LangChain integration — If you use LangChain, add CredianTool to your agent's toolkit for native trust awareness.
4. Monitor your score — Run npx credian score regularly or set up webhook notifications (Growth tier) for score changes.

---

Ready? npx credian login and your agent has trust infrastructure in 30 seconds.