ABAPer

CLI, TUI, and Go SDK for the ABAPer platform — develop, deploy, and test ABAP objects from your terminal, automate SAP workflows in Go, or embed the LSP server in any editor.

The ABAPer Ecosystem

ABAPer is available across multiple surfaces. All share the same backend and AI capabilities.

Client	Repo	Best for
Web IDE	abaper-editor	Browser-based editing, no install
VS Code	abaper-vscode	VS Code users
CLI / TUI	this repo	Terminal workflows, scripting, CI/CD
Go SDK	this repo (`lib/`)	Embedding in Go programs
Eclipse	abaper-eclipse	Eclipse / ADT users (coming soon)

Feature matrix

Feature	Web IDE	VS Code	CLI / TUI
AI pair-programmer chat	✓	✓	✓
Generate ABAP	✓	✓	✓
Deploy & activate	✓	✓	✓
Syntax check / LSP	✓	✓	SDK
Run unit tests	✓	✓	✓
SAP system management	✓	✓	✓
Offline / no browser	—	—	✓
CI/CD integration	—	—	✓
Embed in Go programs	—	—	✓

Installation

One-line installer (macOS / Linux)

sh -c "$(curl -fsSL https://raw.githubusercontent.com/bluefunda/abaper/main/install.sh)"

Installs to /usr/local/bin if writable, otherwise ~/.local/bin. Override with ABAPER_INSTALL_DIR.

Homebrew (macOS)

brew tap bluefunda/tap
brew install --cask abaper

Debian / Ubuntu

VER=$(curl -fsSL https://api.github.com/repos/bluefunda/abaper/releases/latest | grep '"tag_name"' | sed 's/.*"v\([^"]*\)".*/\1/')
ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
curl -sL "https://github.com/bluefunda/abaper/releases/download/v${VER}/abaper_${VER}_linux_${ARCH}.deb" -o abaper.deb
sudo dpkg -i abaper.deb

RHEL / Fedora / Rocky

VER=$(curl -fsSL https://api.github.com/repos/bluefunda/abaper/releases/latest | grep '"tag_name"' | sed 's/.*"v\([^"]*\)".*/\1/')
ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
sudo dnf install "https://github.com/bluefunda/abaper/releases/download/v${VER}/abaper_${VER}_linux_${ARCH}.rpm"

Docker

docker pull ghcr.io/bluefunda/abaper
docker run --rm -v ~/.abaper:/root/.abaper ghcr.io/bluefunda/abaper status

From source

go install github.com/bluefunda/abaper/cmd/abaper@latest

From GitHub Releases

Download the binary for your platform from the releases page.

Platform	Archive
macOS (ARM64)	`abaper_<version>_darwin_arm64.zip`
macOS (AMD64)	`abaper_<version>_darwin_amd64.zip`
Linux (AMD64)	`abaper_<version>_linux_amd64.tar.gz`
Linux (ARM64)	`abaper_<version>_linux_arm64.tar.gz`
Windows (AMD64)	`abaper_<version>_windows_amd64.zip`
Windows (ARM64)	`abaper_<version>_windows_arm64.zip`

Quick Start

# 1. Authenticate with the ABAPer platform
abaper login

# 2. Connect to your SAP system
abaper system add --host https://my-sap:44300 -u DEVELOPER -p secret
abaper system test

# 3. Open the interactive AI chat (TUI)
abaper

# 4. Or drive commands directly
abaper generate --type program --name ZMY_REPORT
abaper deploy --type program --name ZMY_REPORT --source-file report.abap

CLI Reference

Authentication

abaper login       # OAuth2 device flow — opens browser
abaper logout      # Clear stored tokens
abaper status      # Show auth + API health

SAP System Management

Connect the CLI and AI chat to your SAP system. Credentials are stored at ~/.abaper/systems.json (0600) and sent as X-SAP-* headers on every request so the gateway can initialise the SAP MCP server for AI tools.

abaper system add --host https://my-sap:44300 -u USER -p PASS
abaper system add --host https://my-sap:44300 --name "DEV" --client 200 -u USER -p PASS
abaper system list            # show all systems (● = active)
abaper system use "DEV"       # switch active system
abaper system test            # test active system connection
abaper system test "DEV"      # test a specific system
abaper system remove "DEV"

You can also manage systems inside the TUI by typing /system add, /system list, or /system edit <name>.

AI Pair-Programmer

abaper                        # interactive TUI (Bubble Tea chat)
abaper ai chat "Explain SELECT FOR ALL ENTRIES"
abaper ai chat "Optimise this" --context-file program.abap
abaper ai chat "What about performance?" --chat-id <id>

Object Operations

# Generate (create on SAP)
abaper generate --type program --name ZMY_REPORT
abaper generate --type class --name ZCL_MY_CLASS --source-file my_class.abap
abaper generate --type interface --name ZIF_MY_INTERFACE

# Deploy (upload + activate)
abaper deploy --type program --name ZMY_REPORT --source-file report.abap

# Test
abaper test --type class --name ZCL_MY_CLASS

# List
abaper list objects --package ZDEV
abaper list packages --name ZDEV

Object types: program, class, interface

Global Flags

Flag	Default	Description
`--base-url`	`https://api.bluefunda.com`	ABAPer API gateway URL
`--realm`	`trm`	Keycloak realm
`-o`, `--output`	`text`	Output format: `text`, `json`

Configuration

Priority: CLI flags → environment variables → ~/.abaper/config.yaml

# ~/.abaper/config.yaml
base_url: https://api.bluefunda.com
realm: trm
org: default

Environment variable	Description
`ABAPER_BASE_URL`	Override API base URL
`ABAPER_REALM`	Override Keycloak realm
`ABAPER_ORG`	Override organisation

Go SDK

Import the SDK to drive SAP ADT operations directly from Go — no ABAPer platform account required.

go get github.com/bluefunda/abaper/lib

Connect to SAP

import "github.com/bluefunda/abaper/lib"

client, err := lib.CreateADTClient(
    "https://my-sap.example.com:44300",
    "100",        // SAP client number
    "DEVELOPER",
    "secret",
)

Read source

src, err := client.GetProgram(ctx, "ZMY_PROGRAM")
fmt.Println(src.Source)

cls, err := client.GetClass(ctx, "ZCL_MY_CLASS")

Write and activate

err = client.CreateProgram(ctx, "ZMY_PROG", "My program", "$TMP", source)
result, err := client.ActivateObject(ctx, "PROG", "ZMY_PROG")

Search

results, err := client.SearchObjects(ctx, "ZMY_*", []string{"PROG", "CLAS"})
packages, err := client.ListPackages(ctx, "ZDEV*")

Key interfaces (`types/adt.go`)

Interface	Purpose
`SourceReader`	Read ABAP object source
`SourceWriter`	Create and update objects
`PackageBrowser`	Search packages and objects
`ObjectActivator`	Activate objects, run unit tests
`LangFeatures`	LSP-style syntax check, completion, navigation
`ADTClient`	Full interface — all of the above

LSP Server

Embed SAP language intelligence in any LSP-capable editor:

import "github.com/bluefunda/abaper/lsp"

srv := lsp.NewServer(adtClient, "/path/to/workspace")
srv.RunStdio()       // stdio transport (most editors)
// srv.RunTCP(":2087")

Architecture

cmd/abaper/          CLI entry point (Cobra)
tui/                 Bubble Tea TUI — chat + SAP system form
internal/
  commands/          Cobra subcommands
  client/            ABAPer gateway HTTP client (OAuth2 + SAP header injection)
  config/            Config, token, and SAP system storage (~/.abaper/)
  adt/               Direct SAP ADT REST client
  lsp/               LSP server internals
types/               Shared interfaces and ADT data structures
lsp/                 Public LSP server wrapper
rest/                REST API server (CLI feature parity, no AI)
lib/                 Library wrapper for Go embedding

Request flow:

abaper CLI / TUI
      │  Bearer token + X-SAP-{Host,Client,User,Password} headers
      ▼
abaper-gw  (KrakenD gateway — authenticates, routes, starts SAP MCP server)
      │
      ▼
SAP ADT REST API    ◄── also reachable directly via lib/ (no gateway)

Docker

docker pull ghcr.io/bluefunda/abaper:latest

# Persist credentials
docker run --rm -v ~/.abaper:/root/.abaper ghcr.io/bluefunda/abaper status

# One-off deploy
docker run --rm \
  -v ~/.abaper:/root/.abaper \
  -v $(pwd):/workspace \
  ghcr.io/bluefunda/abaper deploy \
    --type program --name ZMY --source-file /workspace/my.abap

Developer Setup

Prerequisites: Go 1.25.1+, golangci-lint

make build        # build for current platform
make build-all    # cross-compile for all platforms
make test         # go test -race ./...
make lint         # golangci-lint
make vet          # go vet

Release Process

Releases are automated via release-please:

Merge PRs with conventional commit titles (feat:, fix:, chore: …)
release-please opens a Release PR with version bump + changelog
Merging the Release PR triggers GoReleaser → multi-platform binaries + Docker image at ghcr.io/bluefunda/abaper

Name		Name	Last commit message	Last commit date
Latest commit History 69 Commits
.github		.github
cmd/abaper		cmd/abaper
docs		docs
editors/zed		editors/zed
examples/docker		examples/docker
hurl		hurl
internal		internal
lib		lib
lsp		lsp
man		man
pkg/output		pkg/output
rest		rest
scripts		scripts
styles		styles
testdata		testdata
tui		tui
types		types
.gitignore		.gitignore
.golangci.yml		.golangci.yml
.goreleaser.yml		.goreleaser.yml
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
Dockerfile		Dockerfile
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
doc.go		doc.go
go.mod		go.mod
go.sum		go.sum
install.sh		install.sh

Folders and files

Latest commit

History

Repository files navigation

ABAPer

The ABAPer Ecosystem

Feature matrix

Installation

One-line installer (macOS / Linux)

Homebrew (macOS)

Debian / Ubuntu

RHEL / Fedora / Rocky

Docker

From source

From GitHub Releases

Quick Start

CLI Reference

Authentication

SAP System Management

AI Pair-Programmer

Object Operations

Global Flags

Configuration

Go SDK

Connect to SAP

Read source

Write and activate

Search

Key interfaces (types/adt.go)

LSP Server

Architecture

Docker

Developer Setup

Release Process

License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 17

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Key interfaces (`types/adt.go`)

Packages