Skip to content
Ódinn ForgeÓdinn Forge Docs

Your first conversation

After onboarding, start the local console:

Terminal window
odinn start

Ódinn opens http://127.0.0.1:18790/ in your browser. The normal gateway binds to loopback only. If you are working on a headless machine:

Terminal window
odinn start --no-open

Send a useful first message

Section titled “Send a useful first message”

Try a request that establishes context without requiring an external side effect:

I’m planning a small product launch. Create a project for it, help me identify the first three decisions, and remember that I prefer concise weekly updates.

This exercises the daily-use concepts:

  • a project groups related work;
  • a session keeps the conversation;
  • a goal records an outcome;
  • memory can suggest durable context for your review;
  • activity shows what the runtime actually did.

Review suggested memories before accepting them. Accepted memory can be global or scoped to a project or session.

Try a safe deterministic check

Section titled “Try a safe deterministic check”

The CLI can exercise the audited runtime without asking a model:

Terminal window
odinn run --tool text.echo --input-json '{"text":"ODINN_OK"}'
odinn runs
odinn audit verify

This advanced example uses structured tool input. The first command records a deterministic local run; the next two let you inspect recent work and verify the audit chain.

When a request needs approval

Section titled “When a request needs approval”

Public web reading is available through the normal tool boundary. Browser clicks, typing, and keypresses that can change an external account require approval by default. Read the request carefully: approval authorizes the action, but it cannot guarantee that a remote service will be reversible.

Next, take a tour of the operator console or learn how projects, sessions, and goals fit together.