Skip to content

Agent Session Interchange Format

Your agent's work
shouldn't be locked
inside one tool.

Changing computers, clouds or providers can mean rebuilding context by hand. The work should be able to come with you.

ASIF records the conversation, selected inputs, files, decisions and unfinished work, together with the prerequisites another environment needs to assess before continuing.

Try ASIF Contribute on GitHub

Open proposal MIT licensed Python & TypeScript

ONE SESSION. MORE POSSIBILITIES.
workshop-planAgent session / ASIF 0.4
JSON
THE WORK, WITH ITS CONTEXT
The shared briefA 90-minute workshop for 12 people.
input
Every contributionThe draft, review and revised plan.
history
Who saw whatExplicit inputs for each agent.

context

A common brief. A traceable handoff.

LaptopCloudAnother agent

Illustrative workflow · no agents are running here

How a handoff fits together

From one environment to the next.

SOURCELocal agent

Conversation, decisions
and working files

Export
PORTABLE RECORDASIF

Inputs · events · checkpoints
Resources · dependencies

Assess & import
DESTINATIONCloud worker

Resolve the environment

DESTINATIONAnother agent

Account for context adaptations

Conceptual flow. Compatible adapters and destination authorization are required; live provider handoffs are not yet demonstrated.

Inspect the synthetic handoff scenario

Built for the handoff

Your next step shouldn't need a fresh start.

01 / PORTABILITY

Change the environment.
Carry the work.

Start on a laptop, assess a cloud destination, and bring the results back. Preserve the relevant files, context and unfinished work along the way.

Explore session portability

02 / COLLABORATION

Different agents.
A shared starting point.

Let a writer, reviewer and editor contribute to one session. Keep the shared brief, their distinct instructions and the source of each contribution visible.

Meet the multi-agent example

03 / CONTINUITY

Keep the decisions.
Make the gaps visible.

Preserve what happened, what an agent received and what remains unresolved. Give the next person or tool an inspectable record to work from.

See more use cases

Try the reference tools

Start with a real document.

Validate an example, then inspect the inputs selected for its reviewer. The local tools let you explore the format without connecting a provider.

Installation and quick start

TerminalNode.js 24+ · from the repository
npm ci
node asif.ts validate \
  examples/multi-agent-review.session.json
node asif.ts request \
  examples/multi-agent-review.session.json \
  reviewer-context
Also available in Python. Examples are synthetic.

Progress you can verify

What you can test today.

Capability Current evidence
Validate documents, inspect selected inputs, package resources Local Python and TypeScript reference checks for a documented subset
Describe a move to another computer or agent Synthetic continuation scenarios with explicit prerequisite assessments
Import a native session and continue on a real destination Integration work; no live handoff demonstrated by this repository

See the compatibility and evidence matrix

Build with us

Bring a session.
Find a gap.

Building an agent, a coding tool or a cloud runtime? Help test whether ASIF captures the information your application needs for a useful handoff.

Start contributing

Share a missing-state exampleShow what your next agent would need to know.

Try an adapterMap a real source and make its limits explicit.

Provide exchange evidenceReproduce a handoff outside the local reference tools.

Inside the documentation

Find your way in.

UNDERSTANDThe specificationIdentity, history, context and the rules that connect them.

BUILDObject referenceFields, types and checked examples for implementers.

EXPLOREWorked examplesShared context, attachments and continuation scenarios.