Skip to content

Quickstart

Create an agent that saves a note. Review the proposed file write before allowing it to run.

1. Install and configure Wardrik

Section titled “1. Install and configure Wardrik”
curl -fsSL https://github.com/wardrik-dev/wardrik/releases/download/wardrik_daemon-v0.1.0-rc.12/install.sh | sh
wardrik init

Choose a model provider and enter your API key. init creates the configuration and starts the daemon. For Docker or non-interactive setup, see Install.

2. Create an agent

Section titled “2. Create an agent”

Save this file as ~/.config/wardrik/agents/notes.md:

~/.config/wardrik/agents/notes.md
---
description: Saves notes for the team.
tools: [files]
policy:
  ask:
    write_file: Review the note before saving it.
---
Save notes when asked. Use the requested filename and text.

The filename sets the agent’s name: notes. The YAML configures its tools and permissions; the Markdown body provides its instructions. It uses the model selected during setup.

3. Request a note

Section titled “3. Request a note”
wardrik reload
wardrik ask notes "Write HELLO.md with the text: Hello from Wardrik."

Wardrik shows the proposed write_file call and prompts for approval. Review the filename and text, then type y to save the note. Press Enter to leave the call pending.

To approve later, list pending calls and copy the call ID:

wardrik approval ls
wardrik approval approve notes CALL_ID

To reject a pending call instead:

wardrik approval deny notes CALL_ID --reason "Use a different filename."

The agent receives the reason and can propose a revised call.

4. Read the saved note

Section titled “4. Read the saved note”
wardrik ask notes "Read HELLO.md and show its contents."

The reply includes Hello from Wardrik. The file is saved in the agent’s persistent workspace, which is separate from your local filesystem.

Next steps

Section titled “Next steps”