Flisk logoflisk/demosHow it worksGitHubSponsor

Personal Flisk demo

@brookservers's Flisk stack

Try it live now

This stack runs on a GitHub runner. Available until 18:02 UTC, then it shuts down and these links stop working. The first load can take a few minutes.

Upvoting lifts this stack toward the top of the list on the home page. One vote per browser. You can also pop a stack's bubble there to vote for it.

Progress

Live, 1h 17m left

  1. ✓
    Plan ready
  2. ✓
    Scaffolding with flisk
  3. ✓
    Repo pushed
  4. ✓
    Starting flisk up on a GitHub runner
  5. ✓
    LiveThe app is running above.

Stacks people made

Most upvoted first, then newest. Open a stack, run it, and press Upvote on its page.

Why this stack

Run it

Fork puts this stack in your own GitHub account, ready to change. On the fork page, untick "Copy the main branch only", then open the branch demo/brookservers-agents-825d7d. Then flisk doctor and flisk up run it on your machine.

Or use the commands
npm install -g @flisk-sh/flisk
git clone -b demo/brookservers-agents-825d7d https://github.com/flisk-sh/demos.git agents-demo
cd agents-demo
flisk doctor
flisk up
Or scaffold it yourself
npm install -g @flisk-sh/flisk
flisk doctor
flisk project --yes
flisk resource web --type frontend --stack agents --framework react --yes
flisk resource api --type backend --stack agents --feature prisma --yes
flisk resource assistant --type agent --stack agents --yes
flisk up agents
flisk status

Open after flisk up

If port 80 is busy, Flisk picks 8080–8180; flisk status shows the exact address.

Your service.json files

One service.json each. Postgres comes from "prisma" and Traefik routing is built in, so neither needs its own file.

webfrontendreact app
// services/agents/web/service.json
{
  "$schema": "https://flisk.sh/schema.service.json",
  "schemaVersion": 1,
  "appName": "web",
  "appType": "frontend",
  "stack": "agents",
  "port": 3000,
  "framework": "react",
  "dependsOn": [
    "api"
  ]
}
apibackendbun + hono API
// services/agents/api/service.json
{
  "$schema": "https://flisk.sh/schema.service.json",
  "schemaVersion": 1,
  "appName": "api",
  "appType": "backend",
  "stack": "agents",
  "port": 4000,
  "healthCheckPath": "/health",
  "dependsOn": [
    "api-migrator"
  ],
  "featuresEnabled": [
    "prisma"
  ]
}
api-migratormigratorruns Prisma migrations against the shared Postgres before the api starts
// services/agents/api-migrator/service.json
{
  "$schema": "https://flisk.sh/schema.service.json",
  "schemaVersion": 1,
  "appName": "api-migrator",
  "appType": "migrator",
  "stack": "agents"
}
assistantagent/health, /ready, x-session-id routing, checkpoints survive restarts
// services/agents/assistant/service.json
{
  "$schema": "https://flisk.sh/schema.service.json",
  "schemaVersion": 1,
  "appName": "assistant",
  "appType": "agent",
  "stack": "agents",
  "port": 4100
}

Note: Next.js support is coming in the next flisk release, so this demo uses React for now.

Make it yours

This stack is a plain git branch. Copy it, change any service.json or the code, and run it on your machine. Send your version back and we can show it here.

1. Copy the branch: the clone command is in Run it above.

2. Put it in your own repository (needs the GitHub CLI)

cd agents-demo && rm -rf .git && git init -q -b main && git add -A && git commit -qm "my agents" && gh repo create my-agents-demo --source . --push --private

Add a badge to your README

Flisk bubble badge

Show that this stack is a Flisk bubble. The badge links back here and shows the upvotes.

Copy the markdown
[![Flisk bubble](https://demo.flisk.sh/badge/brookservers-agents-825d7d.svg)](https://demo.flisk.sh/d/brookservers-agents-825d7d)

Share it

Opens a ready-made post on X. You read it and send it yourself; nothing is posted for you.

Want one for a friend?

Ask @grok on X with their handle and what they build.