Skip to content
Keelson Docs
公式サイト →

All Documentation

Introduction

What is Keelson?

This page is under construction.

Quickstart

This page is under construction.

Core Concepts

This page is under construction.

Building Apps

Supported App Types

This page is under construction.

Build & Runtime

This page is under construction.

Persistent Storage & SQLite

This page is under construction.

App Disk Files

Keelson apps have a persistent /data disk. Use keelson files when an agent needs to change one file on that disk without redeploying the app.

This is useful for Streamlit and data apps that read local CSV or TSV files:

import pandas as pd


df = pd.read_csv("/data/data/sales.tsv", sep="\t")

Commands

Section titled “Commands”

Upload a file:

Terminal window
keelson files put sales.tsv --app sales-dashboard --dest data/sales.tsv --if-not-exists --ndjson

Replace a file intentionally:

Terminal window
keelson files put sales.tsv --app sales-dashboard --dest data/sales.tsv --replace --ndjson

Download a file:

Terminal window
keelson files get data/sales.tsv --app sales-dashboard -o ./sales.tsv --json

Overwrite a local download destination intentionally:

Terminal window
keelson files get data/sales.tsv --app sales-dashboard -o ./sales.tsv --force --json

List a directory:

Terminal window
keelson files ls --app sales-dashboard --path data --json

Remove one file:

Terminal window
keelson files rm data/sales.tsv --app sales-dashboard --yes --json

Agent Guidance

Section titled “Agent Guidance”

For non-interactive agents, prefer --ndjson for put. It waits until the helper Job finishes writing the app disk. --json starts the operation and returns immediately.

Use an explicit conflict mode:

  • --if-not-exists when creating a new file.
  • --if-remote-sha256 <hex> when replacing a file you previously inspected.
  • --replace only when the user explicitly asked to overwrite the file.
  • --force only when the user explicitly asked to overwrite a local download.
  • --yes only when the user explicitly asked to delete the remote file.

If your token can access multiple workspaces, add --tenant <tenant-id>.

Paths and Limits

Section titled “Paths and Limits”

Remote paths are relative to /data. For example, data/sales.tsv maps to /data/data/sales.tsv inside the app container.

Keelson rejects absolute paths, .., symlink components, device files, sockets, FIFOs, directory overwrites, and unsafe database/WAL/journal destructive operations. rm removes regular files only.

The initial file size limit is tuned for single-file data updates. Use snapshots or backups for bulk data, SQLite database replacement, or large directory moves.

Scheduled Jobs (Cron)

This page is under construction.

Configuring with keelson.yaml

This page is under construction.

Deploy

Custom Domains

This page is under construction.

IP Allowlist

This page is under construction.

Access Control

Auth & Login

Members & App Permissions

Workspace

Invite Members

Reference

Keelson Deploy Spec

keelson.yaml

This page is under construction.