feat(import): add hidden 'entire import claude-code' command under labs

dc13899→main·

computermode·3w ago·4 files·+115 added/-0 removed

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

Sessions

dc1cf8d69df4View transcript

[?
Implement Claude History Import FeatureClaude Code·Opus 4.8·3 steps](/content/gh/entireio/cli/session/897809d4-ecab-4dc6-aa21-97661cb62607#timeline-dc1cf8d69df4/index.html)

Changes

4

• cmd/entire/cli

• Aimport_cmd.go+70

• Aimport_cmd_test.go+39

• Mlabs.go+5

• Mroot.go+1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

package cli

import (
    "fmt"
    "time"

"github.com/spf13/cobra"

"github.com/entireio/cli/cmd/entire/cli/importclaude"
    "github.com/entireio/cli/cmd/entire/cli/paths"
)

func newImportCmd() *cobra.Command {
    cmd := &cobra.Command{
        Use:    "import",
        Short:  "Import pre-existing agent history into Entire (experimental)",
        Hidden: true,
        RunE:   func(c *cobra.Command, _ []string) error { return c.Help() },
    }
    cmd.AddCommand(newImportClaudeCodeCmd())
    return cmd
}

func newImportClaudeCodeCmd() *cobra.Command {
    var pathFlag string
    var dryRun bool
    var sessions []string

cmd := &cobra.Command{
        Use:   "claude-code",
        Short: "Import existing Claude Code transcripts as local, read-only checkpoints",
        Long: `Import pre-existing Claude Code transcripts for this repo (the past month)
as local-only, read-only checkpoints. Imported history is searchable and
explainable but is never pushed and not rewindable.`,
        Args: cobra.NoArgs,
        RunE: func(c *cobra.Command, _ []string) error {
            ctx := c.Context()
            repoRoot, err := paths.WorktreeRoot(ctx)
            if err != nil {
                c.SilenceUsage = true
                fmt.Fprintln(c.ErrOrStderr(), "Not a git repository. Run 'entire enable' from within a git repository.")
                return NewSilentError(err)
            }
            repo, err := openRepository(ctx)
            if err != nil {
                return fmt.Errorf("open repository: %w", err)
            }
            defer repo.Close()

res, err := importclaude.Run(ctx, repo, importclaude.Options{
                RepoRoot: repoRoot, OverridePath: pathFlag, SessionFilter: sessions,
                Now: time.Now(), DryRun: dryRun,
            })
            if err != nil {
                return err
            }
            verb := "Imported"
            if dryRun {
                verb = "Would import"
            }
            fmt.Fprintf(c.OutOrStdout(), "%s %d turn(s) from %d session(s) (%d already imported).
",
                verb, res.TurnsImported, res.SessionsScanned, res.TurnsSkipped)
            return nil
            },
        }
    cmd.Flags().StringVar(&pathFlag, "path", "", "Override the Claude projects directory to import from")
    cmd.Flags().BoolVar(&dryRun, "dry-run", false, "Report what would be imported without writing")
    cmd.Flags().StringSliceVar(&sessions, "session", nil, "Import only these session IDs (repeatable)")
    return cmd
}

Acmd/entire/cli/import_cmd.go+70

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

package cli

import (
    "bytes"
    "os"
    "path/filepath"
    "strings"
    "testing"

"github.com/entireio/cli/cmd/entire/cli/testutil"
)

func TestImportClaudeCode_DryRunReportsCounts(t *testing.T) {
    // Not parallel: uses t.Chdir for CWD-based repo/worktree resolution.
    repoDir := t.TempDir()
    testutil.InitRepo(t, repoDir)
    testutil.WriteFile(t, repoDir, "f.txt", "x")
    testutil.GitAdd(t, repoDir, "f.txt")
    testutil.GitCommit(t, repoDir, "init")
     t.Chdir(repoDir)

claudeDir := t.TempDir()
    if err := os.WriteFile(filepath.Join(claudeDir, "s.jsonl"),
        []byte(`{"type":"user","uuid":"u1","message":{"role":"user","content":"hi"}}`+"\n"), 0o644); err != nil {
        t.Fatal(err)
    }

cmd := newImportCmd()
    var out bytes.Buffer
    cmd.SetOut(&out)
    cmd.SetErr(&out)
    cmd.SetArgs([]string{"claude-code", "--path", claudeDir, "--dry-run"})
    if err := cmd.Execute(); err != nil {
        t.Fatalf("execute: %v (out=%q)", err, out.String())
    }
    if !strings.Contains(out.String(), "Would import 1") {
        t.Fatalf("dry-run summary missing count: %q", out.String())
    }
}

Acmd/entire/cli/import_cmd_test.go+39

24 unmodified lines

25
26
27
28
29
30
31
32
33
34
35

24 unmodified lines

Invocation:  "entire investigate",
        Summary:     "Run a multi-agent investigation against a topic, issue, or seed doc",
    },
    {
        CommandPath: []string{"import", "claude-code"},
        Invocation:  "entire import claude-code",
        Summary:     "Import existing Claude Code transcripts as local, read-only history",
    },
    {
        CommandPath: []string{"tokens"},
        Invocation:  "entire tokens",

Mcmd/entire/cli/labs.go+5

89 unmodified lines

90
91
92
93
94
95
96

89 unmodified lines

cmd.AddCommand(newDoctorCmd())          // 'doctor' (group: trace/logs/bundle)
    cmd.AddCommand(newLabsCmd())            // 'labs' (experimental workflow discovery)
    cmd.AddCommand(newPluginGroupCmd())     // 'plugin' (managed install/list/remove)
    cmd.AddCommand(newImportCmd())          // 'import' (hidden; import pre-existing agent history)

// Top-level lifecycle and standalone commands.
    cmd.AddCommand(cliReview.NewCommand(buildReviewDeps(newReviewAttachCmd()))) // hidden during maturation; runs configured review skills