OSA OSAgent

Enter your password to continue

OSA OSAgent
Select a session
0%
Connecting...
+
Start a conversation
Start a new chat to begin
▾
-
Persona
Allow access outside workspace?
- · -
-

Continues across turns. Stop pauses the goal.

Auto
0:00
Workspace
Select a file
Open a file from the tree or review a change from chat.

Context Usage

Context Window
-
Tokens Used
-
Budget
-
0 0% -
Status -
Session Input -
Output -
Cache -
Tool schemas -

Question

Edit Memory

Settings

General
Integrations
Advanced

Appearance

Colors, typography, and chat layout.

Color Palette
Charcoal Red
Midnight Purple
Ocean Blue
Daylight
Coral Dusk
Coral Cream
Sea Glass
Sea Mist
Violet Night
Violet Lavender
Peach Sorbet
Peach Cream
Palettes control background, surfaces, and accent color together.
Typography
Applies to the full UI immediately.
Chat Alignment
Choose between a split conversation layout or the original single-column transcript.
Default visible rows for grouped reads, searches, and parallel tool calls. Click a group to expand or collapse it.

Models

Connect providers and choose which of their models appear in the model menu.

Current Route
Loading...
Default Models
The model the Discord bot runs on. Independent of the chat model.
Titles, summaries, and compaction.
Model Menu
Uses each model's release date from models.dev. Models with no known date always show. Your active model and favourites are never hidden.
Connected
Loading...
Advanced
Local Servers
Live status of Ollama and Unsloth Studio. If Unsloth asks for a key, paste it from Unsloth Desktop (Settings → API keys) below.
Checking...

Agent

How the agent thinks and responds.

Reasoning
Provider/model-specific reasoning options for the active model.
Advanced
Generation
Display streamed and persisted reasoning blocks in the chat transcript
Show the live event and tool-placement diagnostics panel (also toggled with Shift+D)
Show the Workflows button in the header
System Prompt
Replace the default "You are OSA..." identity with custom text
This replaces the entire Identity section in the system prompt. Leave blank to use default.
Replace the default priorities list with custom bullet points
Enter each priority on a new line. These will appear under the "# Priorities" section. Leave blank to use default.

Discord

Run OSA as a bot in your Discord server.

Bot
Connect the bot using the token below.
Saved in the OSAgent config file. Save before starting.
Bot Runtime
Checking status...
Model

The Discord bot shares the active provider route with the desktop app. Picking a model here switches it everywhere.

Loading...
Community Access
Community Access

Restricted support sessions can use public tools only. Trusted access stays separate.

Enable the restricted community policy.
Allow members in listed community servers to chat without a user or role grant.
Applied to restricted community sessions.
Required for all-member access.
Role grants and all-member access never apply to DMs.
GitHub Updates
GitHub Updates
New issues and PRs are announced after startup.
Trusted Full Access
Trusted Full Access

Keep this limited to your personal server and private channels.

Music / Voice Playback
Music / Voice Playback

YouTube audio in voice channels. Requires discord-voice build; yt-dlp auto-downloads to ~/.osagent/bin/. ffmpeg optional (opus passthrough).

Allow /play, /skip, /queue, /stop in voice channels.
Leave blank for auto-download.
For age-restricted / 429 bypass.
Fallback when YouTube blocks.
Backup & Restore
Backup & Restore

Export or import the full Discord bot config including bot tokens. The exported file contains secrets — store it securely.

Voice

Configure voice input and output settings

Voice Input & Output
Turn voice input and voice output features on for the chat interface.
Where dictated mic audio is transcribed. Local Whisper needs the runtime and a model installed below. Offline voice is set up in the card below.
Which engine speaks replies. Local Piper needs the runtime and a voice installed below. Offline voice is set up in the card below.
Used for browser and Local Whisper recording. Device names appear after you grant mic access.
Routes Local Piper playback. Browser speech always follows the system default speaker.
Advanced
Automatically send the transcribed text as soon as voice input finishes instead of leaving it in the chat box for review.
Automatically play assistant responses using the selected speech provider when voice is enabled.
End Local Whisper recording automatically after a pause, so hands-free input does not need a second click.
Speak each tool call as the agent works. Off by default: a long turn queues an utterance per tool, and the final answer cuts the queue short.
Offline Voice

Speech input and output that run on this computer with no network service. One download of about 525 MB. Use it when browser speech is blocked, as it is in the desktop app.

Checking…
Voice Models
Loading models...

Doctor

Run quick health checks for auth, providers, voice, Discord, updates, and network configuration.

System Health
Loading health checks...

Memory

What OSA remembers across sessions.

Facts and preferences OSA can recall.
Rules and conventions OSA follows.

Memories

Enable memory to view and manage memories.
Add a memory
Review queue & decisions

Suggestions

No pending memory suggestions.

Approved decisions

No approved decisions.

Decision suggestions

No pending decision suggestions.
Advanced
How new memory candidates are handled.
How new decision candidates are handled.
Where confirmed memories and suggestions are stored.
Where approved decisions and their audit history are stored.

Security

Manage password protection and network access

Password Protection
Demand password to access the web interface
Change Password
Password updated successfully!
Network Access
Allow access from other devices on your network
Connect from other devices using:
http://192.168.1.100:8765
!
Firewall Warning

Your server will be accessible from other devices on your local network. Make sure your firewall allows connections on port 8765.

Anyone on your network with the server address and password (if set) can access your agent.

Advanced
Leave empty to keep the API same-origin only. Enter one origin per line or comma-separated. Restart required after changes.
Network settings require server restart to take effect.
Server Control
Server restarting...

Pairing

Use OSA from your phone.

Reach OSA remotely through a public address. Needs a password.
The same address every time you start OSA.
Set a password in Security first. Anyone with the link could run tools on this machine.
Disabled.
URL: -
Scan with your phone to pair.
Paired Devices
Loading

Updates

Keep OSAgent up to date

Current version: -
Checking update status…
Latest: -
View Release
0%
Advanced
Channel:
Release Notes
API

Connect Provider

Connect your account

Connected

Account connected

Sign in with your provider account for secure, token-based access.

Enter this code on the verification page:

--------
Open verification page
Waiting for authorization...

Connecting...

or

Use API Key Instead

Get API key from provider
Endpoint
Use provider default (choose later) ▾

Scheduled Jobs

New Scheduled Job

One time is best for reminders; recurring repeats on the chosen schedule.
Supports natural language or cron expressions
Which workspace the job's prompt runs in. An existing chat keeps its own workspace.
Optional. Leave empty to use the last active Discord channel.

Delete Job

Are you sure you want to delete this scheduled job? This cannot be undone.

New workspace

Speaking
Tap to speak
Hold Space to talk · Esc to exit