Skip to main content

Agents

An agent is a database document plus runtime config — not a compiled Rust type. You create one in the UI by filling in fields; Nexus Core stores it and makes it available for scheduling.

Creating an agent (UI shape)​

name: Backend Implementer
slug: backend-implementer
description: Implements backend features in Rust, TypeScript, or C#.

model:
  provider: openai
  model: gpt-5.5-thinking
  temperature: 0.2

runtime:
  image: nexus-agent-runner:latest
  cpu: "2"
  memory: "4Gi"
  timeout_minutes: 60

skills:
  - rust-backend-development
  - mongodb-schema-design
  - api-test-writing
  - git-branch-workflow

memory_scopes:
  - global
  - project
  - agent_private

tools:
  - git
  - shell
  - cargo
  - npm
  - kubectl-readonly
  - plane-comment

permissions:
  can_create_branch: true
  can_commit: true
  can_open_pr: true
  can_merge: false
  can_delete_files: false
  requires_human_approval_for:
    - production_deploy
    - dependency_upgrade
    - database_migration

No Rust code changes to add this agent — it's a document.

Stored document​

{
  "_id": "agent_backend_implementer",
  "name": "Backend Implementer",
  "slug": "backend-implementer",
  "status": "enabled",
  "description": "Implements backend tasks.",
  "model": {
    "provider": "openai",
    "model": "gpt-5.5-thinking",
    "temperature": 0.2
  },
  "runtime": {
    "type": "kubernetes_job",
    "image": "nexus-agent-runner:latest",
    "cpu": "2",
    "memory": "4Gi",
    "timeout_minutes": 60
  },
  "skills": ["rust-backend-development", "mongodb-schema-design"],
  "memory_policy": {
    "read_scopes": ["global", "project", "agent_private"],
    "write_scopes": ["project", "agent_private"],
    "auto_save": true
  },
  "tools": ["git", "shell", "cargo", "plane-comment"],
  "permissions": {
    "can_commit": true,
    "can_open_pr": true,
    "can_merge": false
  },
  "created_at": "2026-05-30T00:00:00Z",
  "updated_at": "2026-05-30T00:00:00Z"
}

Agents page (UI)​

Features:

  • Create agent · Clone agent · Enable / disable agent
  • Assign skills · Choose model · Choose tools · Choose memory scopes
  • Set Kubernetes resources · Set approval rules · View agent performance

Suggested table columns:

Name | Type | Status | Model | Skills | Active Runs | Success Rate | Last Run

How an agent becomes a run​

At dispatch time, Nexus Core:

  1. Loads the agent definition from MongoDB.
  2. Loads the attached skills.
  3. Searches memory (per the read scopes) for relevant context.
  4. Builds the runtime prompt/config.
  5. Creates a Kubernetes Job using the agent's runtime image and resources.

The pod doesn't branch on agent type — it receives the config payload. See Agent run.