Skip to content

Initialize agentd repository with Cargo workspace and project structure #1

@pentaxis93

Description

@pentaxis93

Context

agentd is an open-source autonomous AI agent runtime. "Run autonomous AI agents
on your own infrastructure." Unix daemon convention (like sshd, containerd).

This is the first commit. Everything downstream depends on this structure being
right.

Requirements

Create the following workspace structure (LICENSE already exists in the repo):

agentd/
├── Cargo.toml                  # Workspace root
├── LICENSE                     # Already exists — do not modify
├── README.md                   # See spec below
├── AGENTS.md                   # Stub: "See issue #2"
├── ARCHITECTURE.md             # Stub: "See issue #3"
├── crates/
│   ├── agentd/                 # Main binary
│   │   ├── Cargo.toml
│   │   └── src/
│   │       └── main.rs         # Prints "agentd v0.1.0" and exits
│   ├── agentd-runner/          # Session lifecycle management
│   │   ├── Cargo.toml
│   │   └── src/
│   │       └── lib.rs          # Empty module with doc comment
│   ├── agentd-scheduler/       # Job scheduling
│   │   ├── Cargo.toml
│   │   └── src/
│   │       └── lib.rs
│   ├── agentd-mcp/             # MCP transport (shared)
│   │   ├── Cargo.toml
│   │   └── src/
│   │       └── lib.rs
│   └── forgejo-mcp/            # First MCP plugin
│       ├── Cargo.toml
│       └── src/
│           └── lib.rs
├── docs/
│   └── .gitkeep
└── .github/
    └── .gitkeep

README.md spec

The README must communicate in one screen:

  • What this is (agent runtime daemon)
  • What it does (run autonomous AI agents on your own infrastructure)
  • Current status (early development, not yet functional)

No philosophy. No backstory. No clever metaphors. Technical and direct.

Include sections:

  • One-paragraph description
  • Status badge area (placeholder)
  • Architecture overview (one paragraph pointing to ARCHITECTURE.md)
  • Quick start (placeholder: "Coming soon")
  • License

Cargo workspace

  • Edition 2024
  • Rust version 1.85+
  • Workspace-level dependency management
  • All crates start at version 0.1.0

Verification

  • cargo build succeeds with no warnings
  • cargo test passes (even if no tests yet)
  • cargo clippy clean
  • README renders correctly on GitHub

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions